HttpTerminate-Funktion (http.h)

  • Artikel

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