Função HttpTerminate (http.h)

  • Artigo

A função HttpTerminate limpa os recursos usados pela API do servidor HTTP para processar chamadas por um aplicativo. Um aplicativo deve chamar HttpTerminate uma vez para cada vez que ele chamou HttpInitialize, com configurações de sinalizador correspondentes.

Sintaxe

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

Parâmetros

[in] Flags

Opções de encerramento. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
HTTP_INITIALIZE_CONFIG
 Libere todos os recursos usados por aplicativos que modificam a configuração HTTP.
HTTP_INITIALIZE_SERVER
 Libere todos os recursos usados por aplicativos de servidor.

[in, out] pReserved

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor Significado
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros fornecidos estão em uma forma inutilizável.
Outros
 Um código de erro do sistema definido em WinError.h.

Comentários

Cada chamada para HttpInitialize deve ser correspondida por uma chamada correspondente para HttpTerminate. Por exemplo, se você chamar HttpInitialize com HTTP_INITIALIZE_SERVER, deverá chamar HttpTerminate com HTTP_INITIALIZE_SERVER. Se você chamar HttpInitialize duas vezes, uma vez com HTTP_INITIALIZE_SERVER e a segunda vez com HTTP_INITIALIZE_CONFIG, você poderá chamar HttpTerminate uma vez com ambos os sinalizadores.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho http.h
Biblioteca Httpapi.lib
DLL Httpapi.dll

Confira também

Funções da API do Servidor HTTP versão 1.0

HttpInitialize