PostQueuedCompletionStatus 函式 (ioapiset.h)

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

語法

BOOL PostQueuedCompletionStatus(
  [in]           HANDLE       CompletionPort,
  [in]           DWORD        dwNumberOfBytesTransferred,
  [in]           ULONG_PTR    dwCompletionKey,
  [in, optional] LPOVERLAPPED lpOverlapped
);

參數

[in] CompletionPort

要張貼 I/O 完成封包之 I/O 完成埠的句柄。

[in] dwNumberOfBytesTransferred

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

[in] dwCompletionKey

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

[in, optional] lpOverlapped

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

傳回值

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

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

備註

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

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

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	Yes
SMB 3.0 透明故障轉移 (TFO)	Yes
具有向外延展檔案共用的SMB 3.0 (SO)	Yes
叢集共用磁碟區文件系統 (CsvFS)	Yes
彈性檔案系統 (ReFS)	Yes

 

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

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	ioapiset.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

CreateIoCompletionPort

檔案管理功能

GetQueuedCompletionStatus

重疊