CloseThreadpoolIo-Funktion (threadpoolapiset.h)

Gibt das angegebene E/A-Vervollständigungsobjekt frei.

Syntax

void CloseThreadpoolIo(
  [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

Das E/A-Vervollständigungsobjekt wird sofort freigegeben, wenn keine ausstehenden Rückrufe vorhanden sind. Andernfalls wird das E/A-Vervollständigungsobjekt asynchron freigegeben, nachdem die ausstehenden Rückrufe abgeschlossen sind.

Sie sollten das zugeordnete Dateihandle schließen und warten, bis alle ausstehenden überlappenden E/A-Vorgänge abgeschlossen sind, bevor Sie diese Funktion aufrufen. Nach dem Aufruf dieser Funktion dürfen keine überlappenden E/A-Vorgänge mehr auftreten.

Es kann erforderlich sein, Threadpool-E/A-Benachrichtigungen abzubrechen, um Speicherverluste zu verhindern. Weitere Informationen finden Sie unter CancelThreadpoolIo.

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

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

Siehe auch

CancelThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Threadpools

WaitForThreadpoolIoCallbacks