ReadFile function

从指定文件中读数据


Function:

int UAPI ReadFile(
        int hFile,
        bytes pBuffer,
        int nSize
);

int UAPI ReadFile_s(
        int hFile,
        bytes pBuffer,
        int nSize
);

Parameters:

  • hFile [in]:文件句柄
  • pBuffer [out]:读入缓冲区
  • nSize [in]:读入大小

Return value:

  • Type:int
  • Text:成功返回实际读入文件大小(byte),失败返回 NULL

Remarks:

  1. 开发者应确保 pBuffer 参数所指定的缓冲区拥有足够的内存区域大小用于存放 nSize 参数指定大小所读入的数据,否则会导致内存溢出
  2. 开发者应使用 BytesSpace function 对 pBuffer 进行初始化
  3. 开发者可以使用 SDK 提供的更安全的 ReadFile_s function,以防止输入输出参数异常导致的应用程序崩溃或不可预知的后果。但 ReadFile_s function 的性能略低
  4. ReadFile_s function 为 SDK 中所导出的,在符号服务器 kext 中并不存在 ReadFile_s function
  5. 考虑到 ReadFile function 的执行性能因素,因此其采用最小化参数合法检查,开发者应确保其参数的正确性或使用 ReadFile_s function

Requirements:

Keyword Value
Minimum Agine Version 171012.1
Minimum SDK Version 171012.1
Header File h.files
Library Server kext

results matching ""

    No results matching ""