PostQueuedCompletionStatus-Funktion

Postet 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-Abschlussport, an den das E/A-Vervollständigungspaket gesendet werden soll.

dwNumberOfBytesTransferred [ In]

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

dwCompletionKey [ In]

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

lpOverlapped [ in, optional]

Der Wert, der durch 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 zu erhalten.

Hinweise

Das E/A-Abschlusspaket 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. Das System verwendet oder überprüft diese Werte nicht. 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 Dateifreigaben mit aufskalieren (SO)
Ja
Freigegebenes Clustervolume Dateisystem (CsvFS)
Ja
Robustes Dateisystem (Resilient File System, ReFS)
Ja

CsvFs werden für komprimierte Dateien umgeleitete E/A-Dateien verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [XP-Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)
Windows UWP-Apps für Server [ 2003-Desktop-Apps |]
Header
IoAPI.h (include Windows.h);
WinBase.h auf 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

Weitere Informationen

CreateIoCompletionPort

Dateiverwaltungsfunktionen

GetQueuedCompletionStatus

ÜBERLAPPENDE