CancelThreadpoolIo-Funktion (threadpoolapiset.h)

Bricht die Benachrichtigung über die Funktion StartThreadpoolIo ab.

Syntax

void CancelThreadpoolIo(
  [in, out] PTP_IO pio
);

[in, out] pio

Ein Zeiger auf eine TP_IO-Struktur , die das E/A-Vervollständigungsobjekt definiert. Die CreateThreadpoolIo-Funktion gibt diesen Zeiger zurück.

Keine

Um Speicherverluste zu verhindern, müssen Sie die CancelThreadpoolIo-Funktion für eines der folgenden Szenarien aufrufen:

Ein überlappender (asynchroner) E/A-Vorgang schlägt fehl (d. h. der asynchrone E/A-Funktionsaufruf gibt einen Fehler mit einem anderen Fehlercode als ERROR_IO_PENDING zurück).
Ein asynchroner E/A-Vorgang wird sofort erfolgreich zurückgegeben, und das dem E/A-Vervollständigungsobjekt zugeordnete Dateihandle weist den Benachrichtigungsmodus FILE_SKIP_COMPLETION_PORT_ON_SUCCESS auf. Das Dateihandle benachrichtigt den E/A-Vervollständigungsport nicht, und die zugehörige E/A-Rückruffunktion wird nicht aufgerufen.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	threadpoolapiset.h (einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll