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

Siehe auch

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Threadpools

WaitForThreadpoolIoCallbacks