Funzione PostQueuedCompletionStatus

Inserisce un pacchetto di completamento di I/O in una porta di completamento I/O.

Sintassi

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

Parametri

CompletionPort [in]

Handle per una porta di completamento di I/O in cui deve essere inserito il pacchetto di completamento di I/O.

dwNumberOfBytesTransferred [in]

Valore da restituire tramite il parametro lpNumberOfBytesTransferred della funzione GetQueuedCompletionStatus .

dwCompletionKey [in]

Valore da restituire tramite il parametro lpCompletionKey della funzione GetQueuedCompletionStatus .

lpOverlapped [in, facoltativo]

Valore da restituire tramite il parametro lpOverlapped della funzione GetQueuedCompletionStatus .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare GetLastError .

Commenti

Il pacchetto di completamento di I/O soddisfa una chiamata in sospeso alla funzione GetQueuedCompletionStatus . Questa funzione restituisce con i tre valori passati come secondo, terzo e quarto parametro della chiamata a PostQueuedCompletionStatus. Il sistema non usa o convalida questi valori. In particolare, il parametro lpOverlapped non deve puntare a una struttura OVERLAPPED .

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	Sì
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (ReFS)	Sì

CsvFs eseguirà operazioni di I/O reindirizzate per i file compressi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Intestazione	IoAPI.h (include Windows.h); WinBase.h in Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

CreateIoCompletionPort

Funzioni di gestione file

GetQueuedCompletionStatus

SOVRAPPOSTA