共用方式為


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

重疊