Função HttpWaitForDisconnect (http.h)

  • Artigo

A função HttpWaitForDisconnect notifica o aplicativo quando a conexão com um cliente HTTP é interrompida por qualquer motivo.

Sintaxe

HTTPAPI_LINKAGE ULONG HttpWaitForDisconnect(
  [in] HANDLE             RequestQueueHandle,
  [in] HTTP_CONNECTION_ID ConnectionId,
  [in] LPOVERLAPPED       Overlapped
);

Parâmetros

[in] RequestQueueHandle

Um identificador para a fila de solicitações que manipula solicitações da conexão especificada. Uma fila de solicitação é criada e seu identificador retornado por uma chamada para a função HttpCreateRequestQueue .

Windows Server 2003 com SP1 e Windows XP com SP2: O identificador para a fila de solicitação é criado pela função HttpCreateHttpHandle .

[in] ConnectionId

Identificador da conexão com o computador cliente. Esse valor é retornado no membro ConnectionID da estrutura HTTP_REQUEST por uma chamada para a função HttpReceiveHttpRequest .

[in] Overlapped

Para chamadas assíncronas, defina pOverlapped para apontar para uma estrutura OVERLAPPED ; para chamadas síncronas, defina-a como NULL.

Uma chamada síncrona é bloqueada até que a conexão seja interrompida, enquanto uma chamada assíncrona retorna imediatamente ERROR_IO_PENDING e o aplicativo de chamada usa as portas de conclusão GetOverlappedResult ou de E/S para determinar quando a operação é concluída. Para obter informações sobre como usar estruturas OVERLAPPED para sincronização, consulte Sincronização e entrada e saída sobrepostas.

Valor retornado

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

Se a função for usada de forma assíncrona, um valor retornado de ERROR_IO_PENDING indicará que a próxima solicitação ainda não está pronta e será recuperada posteriormente por meio de mecanismos normais de conclusão de E/S sobrepostos.

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

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.

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

HTTP_REQUEST