当前位置:首页 科普知识 ReadFileEx

ReadFileEx

发布时间:2023-09-06 21:30:05

ReadFileEx是一个Windows API函数。与ReadFile相似,只是它只能用于异步读取文件操作,异步操作完成后会调用指定的回调函数。

ReadFileEx详细介绍

ReadFileEx是一个Windows API函数。与ReadFile相似,只是它只能用于异步读取文件操作,异步操作完成后会调用指定的回调函数。

ReadFileEx语法

BOOLReadFileEx(

HANDLEhFile, //文件的句柄

LPVOIDlpBuffer, //用于接收数据的缓冲区

DWORDnNumberOfByteToRead, //允许接收的最大字节数

LPOVERLAPPEDlpOverlapped, //一个OVERLAPPED结构的指针

LPOVERLAPPED_COMPLETION_ROUTINElpCompletionRoutine //异步读取完成后调用的回调函数

);

ReadFileExVB声明

Declare Function ReadFileEx Lib "kernel32" Alias "ReadFileEx" (ByVal hFile As Long, lpBuffer As Any, ByVal nNumberOfBytesToRead As Long, lpOverlapped As OVERLAPPED, ByVal lpCompletionRoutine As Long) As Long

ReadFileEx参数

hFile

文件的句柄。这个参数可以是任何一个由带有FILE_FLAG_OVERLAPPED参数的CreateFile函数打开的句柄。这个句柄同时也需要有GENERIC_WRITE访问权限。

lpBuffer

指定容纳读入数据的一个缓冲区。除非读操作执行完毕,否则不要访问这个缓冲区。

nNumberOfBytesToRead

要读入的字节数。

lpOverlapped

一个指向OVERLAPPED类型的结构体指针,定义了一个异步操作的结构。使用这个函数时,结构中的hEvent字段会被忽略

lpCompletionRoutine

回调函数的返回值。

ReadFileEx返回值

返回非零表示成功,返回零表示失败,并可用GetLastError得到错误代码。

ReadFileEx其他信息

在Windows 8和Windows Server 2012中,这个函数也被下列技术所支持:

技术

支持

Server Message Block(SMB) 3.0 protocol

SMB 3.0 Transparent Failover (TFO)

Cluster Shared Volume File System (CsvFS)

弹性文件系统 (ReFS)

ReadFileEx需求

客户端

需要Windows XP、Windows 2000 Professional、Windows NT Workstation、Windows Me、Windows 98或Windows 95。

服务器

需要Windows Server 2003、Windows 2000 Server或Windows NT Server。

头文件

在Winbase.h中声明,包含于Windows.h。

库文件

Kernel32.lib。

DLL

需要Kernel32.dll。

温馨提示:
本文【ReadFileEx】由作者 爱百科 转载提供。 该文观点仅代表作者本人, 自学教育网 信息发布平台,仅提供信息存储空间服务, 若存在侵权问题,请及时联系管理员或作者进行删除。
(c)2008-2025 自学教育网 All Rights Reserved 汕头市灵创科技有限公司
粤ICP备2024240640号-6