HttpTerminate-Funktion (http.h)

Die HttpTerminate-Funktion bereinigt Ressourcen, die von der HTTP-Server-API zum Verarbeiten von Aufrufen einer Anwendung verwendet werden. Eine Anwendung sollte HttpTerminate einmal aufrufen, wenn sie HttpInitialize mit übereinstimmenden Flageinstellungen aufgerufen hat.

Syntax

HTTPAPI_LINKAGE ULONG HttpTerminate(
  [in]      ULONG Flags,
  [in, out] PVOID pReserved
);

Parameter

[in] Flags

Beendigungsoptionen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
HTTP_INITIALIZE_CONFIG	Geben Sie alle Ressourcen frei, die von Anwendungen verwendet werden, die die HTTP-Konfiguration ändern.
HTTP_INITIALIZE_SERVER	Geben Sie alle Ressourcen frei, die von Serveranwendungen verwendet werden.

[in, out] pReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Mindestens einer der angegebenen Parameter ist in einer nicht verwendbaren Form.
Andere	Ein in WinError.h definierter Systemfehlercode .

Hinweise

Jeder Aufruf von HttpInitialize sollte durch einen entsprechenden Aufruf von HttpTerminate abgeglichen werden. Wenn Sie beispielsweise HttpInitialize mit HTTP_INITIALIZE_SERVER aufrufen, müssen Sie HttpTerminate mit HTTP_INITIALIZE_SERVER aufrufen. Wenn Sie HttpInitialize zweimal aufrufen, einmal mit HTTP_INITIALIZE_SERVER und das zweite Mal mit HTTP_INITIALIZE_CONFIG, können Sie HttpTerminate einmal mit beiden Flags aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	http.h
Bibliothek	Httpapi.lib
DLL	Httpapi.dll

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpInitialize