PostQueuedCompletionStatus 函式

將 I/O 完成封包張貼至 I/O 完成埠。

語法

BOOL WINAPI PostQueuedCompletionStatus(
  _In_     HANDLE       CompletionPort,
  _In_     DWORD        dwNumberOfBytesTransferred,
  _In_     ULONG_PTR    dwCompletionKey,
  _In_opt_ LPOVERLAPPED lpOverlapped
);

參數

CompletionPort [in]

要張貼 I/O 完成封包之 I/O 完成埠的控制碼。

dwNumberOfBytesTransferred [in]

要透過GetQueuedCompletionStatus函式的 lpNumberOfBytesTransferred參數傳回的值。

dwCompletionKey [in]

要透過GetQueuedCompletionStatus函式的 lpCompletionKey參數傳回的值。

lpOverlapped [in， optional]

要透過GetQueuedCompletionStatus函式的lpOverlapped參數傳回的值。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 。

備註

I/O 完成封包會滿足 GetQueuedCompletionStatus 函式的未完成呼叫。 此函式會傳回三個值，這些值會傳遞為 PostQueuedCompletionStatus呼叫的第二、第三和第四個參數。 系統不會使用或驗證這些值。 特別是， lpOverlapped 參數不需要指向 重迭 結構。

在Windows 8和Windows Server 2012中，下列技術支援此函式。

技術	支援
伺服器訊息區 (SMB) 3.0 通訊協定	是
SMB 3.0 透明容錯移轉 (TFO)	是
具有向外延展檔案共用的 SMB 3.0 (SO)	是
叢集共用磁片區檔案系統 (CsvFS)	是
彈性檔案系統 (ReFS)	是

CsvF 會針對壓縮檔進行重新導向的 IO。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
標頭	IoAPI.h (包括 Windows.h) ; Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP (上的 WinBase.h 包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

CreateIoCompletionPort

檔案管理功能

GetQueuedCompletionStatus

重疊