WINBASEAPI

BOOL

WINAPI

GetOverlappedResult(

    _In_ HANDLE hFile,

    _In_ LPOVERLAPPED lpOverlapped,

    _Out_ LPDWORD lpNumberOfBytesTransferred,

    _In_ BOOL bWait

);

外文名

GetOverlappedResult

说    明

判断一个重叠操作当前的状态

Long

非零表示成功，零表示失败

设    置

GetLastError

参数说明

判断一个重叠操作当前的状态

返回值

Long，非零表示成功，零表示失败。会设置GetLastError。如bWait为FALSE，而且异步操作仍在执行，则函数回返回零，而GetLastError会设置成ERROR_IO_INCOMPLETE

参数表

参数 类型及说明

hFile Long，指定一个文件、管道或通信设备的句柄

lpOverlapped OVERLAPPED，为欲检查的I/O操作指定的一个结构

lpNumberOfBytesTransferred Long，用于容纳传输字节数量的一个变量

bWait Long，如果为TRUE，就一直等到异步操作结束才返回。FALSE表示立即返回

GetOverlappedResult函数:

BOOL GetOverlappedResult(

HANDLE hFile, // 串口的句柄

// 指向重叠操作开始时指定的OVERLAPPED结构

LPOVERLAPPED lpOverlapped,

// 指向一个32位变量，该变量的值返回实际读写操作传输的字节数。

LPDWORD lpNumberOfBytesTransferred,

// 该参数用于指定函数是否一直等到重叠操作结束。

// 如果该参数为TRUE，函数直到操作结束才返回。

// 如果该参数为FALSE，函数直接返回，这时如果操作没有完成，

// 通过调用GetLastError()函数会返回ERROR_IO_INCOMPLETE。

BOOL bWait

);

该函数返回重叠操作的结果，用来判断异步操作是否完成，它是通过判断OVERLAPPED结构中的hEvent是否被置位来