InternetCloseHandle-Funktion (wininet.h)

Artikel
08/27/2023

Schließt ein einzelnes Internethandle.

Syntax

BOOL InternetCloseHandle(
  [in] HINTERNET hInternet
);

Parameter

[in] hInternet

Das zu schließende Handle.

Rückgabewert

Gibt TRUE zurück, wenn das Handle erfolgreich geschlossen wurde, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Funktion beendet alle ausstehenden Vorgänge für das Handle und verwirft alle ausstehenden Daten.

Es ist sicher, InternetCloseHandle aufzurufen, solange keine API-Aufrufe ausgeführt werden oder über das Handle erfolgen. Nachdem eine API ERROR_IO_PENDING zurückgegeben hat, ist es sicher, InternetCloseHandle aufzurufen, um diese E/A abzubrechen, solange keine nachfolgenden API-Aufrufe mit dem Handle ausgegeben werden.

Es ist sicher, InternetCloseHandle in einem Rückruf für das zu schließende Handle aufzurufen. Wenn ein status Rückruf für das zu schließende Handle registriert ist und das Handle mit einem Nicht-NULL-Kontextwert erstellt wurde, wird ein INTERNET_STATUS_HANDLE_CLOSING Rückruf durchgeführt. Diese Angabe ist der letzte Rückruf aus einem Handle und gibt an, dass das Handle zerstört wird.

Wenn asynchrone Anforderungen für das Handle oder eines seiner untergeordneten Handles ausstehen, kann das Handle nicht sofort geschlossen werden, wird aber ungültig. Alle neuen Anforderungen, die mit dem Handle versucht werden, werden mit einer ERROR_INVALID_HANDLE Benachrichtigung zurückgegeben. Die asynchronen Anforderungen werden mit INTERNET_STATUS_REQUEST_COMPLETE abgeschlossen. Die Anträge müssen darauf vorbereitet sein, INTERNET_STATUS_REQUEST_COMPLETE Hinweise auf dem Handle zu erhalten, bevor die endgültige INTERNET_STATUS_HANDLE_CLOSING Angezeigt wird, was darauf hinweist, dass der Ziehpunkt vollständig geschlossen ist.

Eine Anwendung kann GetLastError aufrufen, um zu bestimmen, ob Anforderungen ausstehen. Wenn GetLastErrorERROR_IO_PENDING zurückgibt, gab es ausstehende Anforderungen, als das Handle geschlossen wurde.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll