PostQueuedCompletionStatus

The PostQueuedCompletionStatus function lets you post an I/O completion packet to an I/O completion port. The I/O completion packet will satisfy an outstanding call to the GetQueuedCompletionStatus function. The GetQueuedCompletionStatus function returns with the three values passed as the second, third, and fourth parameters of the call to PostQueuedCompletionStatus.

BOOL PostQueuedCompletionStatus(
  HANDLE CompletionPort,  // handle to an I/O completion port
  DWORD dwNumberOfBytesTransferred,  // value to return via 
                          // GetQueuedCompletionStatus' 
                          // lpNumberOfBytesTranferred
  DWORD dwCompletionKey,  // value to return via 
                          // GetQueuedCompletionStatus' 
                          // lpCompletionKey
  LPOVERLAPPED lpOverlapped  // value to return via 
                             // GetQueuedCompletionStatus' lpOverlapped
);
 

Parameters

CompletionPort
Handle to an I/O completion port that you want to post an I/O completion packet to.
dwNumberOfBytesTransferred
Specifies a value to be returned through the lpNumberOfBytesTransferred parameter of the GetQueuedCompletionStatus function.
dwCompletionKey
Specifies a value to be returned through the lpCompletionKey parameter of the GetQueuedCompletionStatus function.
lpOverlapped
Specifies a value to be returned through the lpOverlapped parameter of the GetQueuedCompletionStatus function.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError .

Remarks

For more information concerning dwNumberOfBytesTransferred, dwCompletionKey, and lpOverlapped, see GetQueuedCompletionStatus and the descriptions of the parameters those values are returned through.

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.
  Import Library: Use kernel32.lib.

See Also

File I/O Overview, File Functions, CreateIoCompletionPort, GetQueuedCompletionStatus, OVERLAPPED