Função HttpCreateHttpHandle (http.h)
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 |
|---|---|
|
O aplicativo de chamada não chamou HttpInitialize antes de chamar essa função. |
|
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 |