CancelThreadpoolIo-Funktion (threadpoolapiset.h)
Bricht die Benachrichtigung über die Funktion StartThreadpoolIo ab.
Syntax
void CancelThreadpoolIo(
[in, out] PTP_IO pio
);
Parameter
[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.
Rückgabewert
Keine
Bemerkungen
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.
Anforderungen
| 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 |