Função HttpInitialize (http.h)

  • Artigo

A função HttpInitialize inicializa o driver de API do servidor HTTP, inicia-o, se ainda não foi iniciado e aloca estruturas de dados para o aplicativo de chamada para dar suporte à criação da fila de resposta e outras operações. Chame essa função antes de chamar outras funções na API do Servidor HTTP.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Parâmetros

[in] Version

Versão HTTP. Esse parâmetro é uma estrutura HTTPAPI_VERSION . Para a versão atual, declare uma instância da estrutura e defina-a como o valor predefinido HTTPAPI_VERSION_1 antes de passá-la para HttpInitialize.

[in] Flags

Opções de inicialização, que podem incluir um ou ambos os valores a seguir.

Valor Significado
HTTP_INITIALIZE_CONFIG
 Execute a inicialização para aplicativos que usam as funções de configuração HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration e HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER
 Execute a inicialização para aplicativos que usam a API do Servidor HTTP.

[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 códigos de erro a seguir.

Valor Significado
ERROR_INVALID_PARAMETER
 O parâmetro Flags contém um valor sem suporte.
Outros
 Um código de erro do sistema definido em WinError.h.

Comentários

Chame HttpTerminate quando o aplicativo for concluído. Todos os mesmos sinalizadores que foram passados para HttpInitialize no parâmetro Flags também devem ser passados para HttpTerminate. Um aplicativo pode chamar HttpInitialize repetidamente, desde que cada chamada para HttpInitialize seja correspondida posteriormente por uma chamada correspondente para HttpTerminate.

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