Fonction PostQueuedCompletionStatus

Publie un paquet d’achèvement d’E/S sur un port d’achèvement d’E/S.

Syntaxe

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

Paramètres

CompletionPort [in]

Handle vers un port d’achèvement d’E/S dans lequel le paquet d’achèvement d’E/S doit être publié.

dwNumberOfBytesTransferred [in]

Valeur à retourner via le paramètre lpNumberOfBytesTransferred de la fonction GetQueuedCompletionStatus .

dwCompletionKey [in]

Valeur à retourner via le paramètre lpCompletionKey de la fonction GetQueuedCompletionStatus .

lpOverlapped [in, facultatif]

Valeur à retourner via le paramètre lpOverlapped de la fonction GetQueuedCompletionStatus .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError .

Notes

Le paquet de saisie semi-automatique d’E/S satisfait à un appel en suspens à la fonction GetQueuedCompletionStatus . Cette fonction retourne avec les trois valeurs passées en tant que deuxième, troisième et quatrième paramètres de l’appel à PostQueuedCompletionStatus. Le système n’utilise ni ne valide ces valeurs. En particulier, le paramètre lpOverlapped n’a pas besoin de pointer vers une structure CHEVAUCHEMENT.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technology	Prise en charge
Protocole SMB (Server Message Block) 3.0	Oui
Basculement transparent (TFO) SMB 3.0	Oui
SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO)	Oui
Cluster Shared Volume File System (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

CsvFs effectue les E/S redirigées pour les fichiers compressés.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | Applications UWP]
En-tête	IoAPI.h (inclure Windows.h) ; WinBase.h sur Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP (y compris Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateIoCompletionPort

Fonctions de gestion de fichiers

GetQueuedCompletionStatus

SE CHEVAUCHENT