HttpTerminate function (http.h)

Article
02/22/2024

The HttpTerminate function cleans up resources used by the HTTP Server API to process calls by an application. An application should call HttpTerminate once for every time it called HttpInitialize, with matching flag settings.

Syntax

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

Parameters

[in] Flags

Termination options. This parameter can be one or more of the following values.

Value	Meaning
HTTP_INITIALIZE_CONFIG	Release all resources used by applications that modify the HTTP configuration.
HTTP_INITIALIZE_SERVER	Release all resources used by server applications.

[in, out] pReserved

This parameter is reserved and must be NULL.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value	Meaning
ERROR_INVALID_PARAMETER	One or more of the supplied parameters is in an unusable form.
Other	A system error code defined in WinError.h.

Remarks

Every call to HttpInitialize should be matched by a corresponding call to HttpTerminate. For example, if you call HttpInitialize with HTTP_INITIALIZE_SERVER, you must call HttpTerminate with HTTP_INITIALIZE_SERVER. If you call HttpInitialize twice, once with HTTP_INITIALIZE_SERVER and the second time with HTTP_INITIALIZE_CONFIG, you can call HttpTerminate one time with both flags.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	http.h
Library	Httpapi.lib
DLL	Httpapi.dll