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 |
|
| Libreria |
|
| DLL |
|