Função HttpCreateHttpHandle (http.h)

  • Artigo

A função HttpCreateHttpHandle cria uma fila de solicitação HTTP para o aplicativo de chamada e retorna um identificador para ele.

A partir da versão 2.0 da API do Servidor HTTP, os aplicativos devem chamar HttpCreateRequestQueue para criar a fila de solicitações; HttpCreateHttpHandle não deve ser usado.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Parâmetros

[out] RequestQueueHandle

Um ponteiro para uma variável que recebe um identificador para a fila de solicitação.

[in] Reserved

Reservado. Esse parâmetro deve ser zero.

Valor retornado

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_DLL_INIT_FAILED
 O aplicativo de chamada não chamou HttpInitialize antes de chamar essa função.
Outros
 Um código de erro do sistema definido em WinError.h.

Comentários

A fila de solicitações permite que o aplicativo de chamada receba solicitações para URLs específicas. O aplicativo de chamada usa a função HttpAddUrl para especificar a URL para a qual deve receber solicitações.

Um aplicativo deve usar uma única fila de solicitações para receber solicitações. O uso de várias filas de solicitação de um único processo não aumenta o tempo de resposta ou a taxa de transferência.

Quando um aplicativo terminar de receber solicitações, ele deverá chamar a função CloseHandle para fechar o identificador.

Requisitos

   
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

HttpAddUrl

HttpCreateRequestQueue