PostQueuedCompletionStatus-Funktion

Sendet ein E/A-Vervollständigungspaket an einen E/A-Abschlussport.

Syntax

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

Parameter

CompletionPort [in]

Ein Handle für einen E/A-Vervollständigungsport, an den das E/A-Vervollständigungspaket gesendet werden soll.

dwNumberOfBytesTransferred [in]

Der Wert, der über den lpNumberOfBytesTransferred-Parameter der GetQueuedCompletionStatus-Funktion zurückgegeben werden soll.

dwCompletionKey [in]

Der Wert, der über den lpCompletionKey-Parameter der GetQueuedCompletionStatus-Funktion zurückgegeben werden soll.

lpOverlapped [in, optional]

Der Wert, der über den lpOverlapped-Parameter der GetQueuedCompletionStatus-Funktion zurückgegeben werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Das E/A-Vervollständigungspaket erfüllt einen ausstehenden Aufruf der GetQueuedCompletionStatus-Funktion . Diese Funktion gibt mit den drei Werten zurück, die als zweiter, dritter und vierter Parameter des Aufrufs von PostQueuedCompletionStatus übergeben werden. Diese Werte werden vom System nicht verwendet oder überprüft. Insbesondere muss der lpOverlapped-Parameter nicht auf eine OVERLAPPED-Struktur verweisen.

In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
Server Message Block (SMB) 3.0-Protokoll	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Horizontalskalieren von Dateifreigaben (SO)	Ja
Freigegebenes Clustervolume-Dateisystem (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

CsvFs führen umgeleitete E/A für komprimierte Dateien aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Header	IoAPI.h (einschließlich Windows.h); WinBase.h unter Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CreateIoCompletionPort

Dateiverwaltungsfunktionen

GetQueuedCompletionStatus

ÜBERLAPPENDE