將 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 應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|