Compartilhar via


Interface IWinHttpRequestEvents

A interface IWinHttpRequestEvents fornece eventos para Os Serviços HTTP do Microsoft Windows (WinHTTP). Ele usa apenas métodos de evento.

Membros

A interface IWinHttpRequestEvents herda da interface IUnknown . IWinHttpRequestEvents também tem esses tipos de membros:

Métodos

A interface IWinHttpRequestEvents tem esses métodos.

Método Descrição
OnError Ocorre quando há um erro em tempo de execução no aplicativo.
OnResponseDataAvailable Ocorre quando os dados estão disponíveis na resposta.
OnResponseFinished Ocorre quando os dados de resposta são concluídos.
OnResponseStart Ocorre quando os dados de resposta começam a ser recebidos.

Comentários

O procedimento a seguir descreve como se registrar para notificações.

  1. Obtenha uma interface IConnectionPointContainer chamando QueryInterface em um objeto IWinHttpRequest .
  2. Chame FindConnectionPoint na interface retornada e passe IID_IWinHttpRequestEvents para riid.
  3. Chame Advise no ponto de conexão retornado e passe um ponteiro para uma interface IUnknown em um objeto que implementa IWinHttpRequestEvents para pUnk.

As notificações podem ser encerradas chamando Unadvise no ponto de conexão retornado na etapa 2.

Para exibir alguns códigos que se registram para notificações COM, consulte a seção Cliente do artigo Pontos de Conexão COM .

Observação

Para Windows XP e Windows 2000, consulte a seção Requisitos de tempo de execução da Página Inicial do WinHTTP.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Redistribuível
WinHTTP 5.0 e Internet Explorer 5.01 ou posterior no Windows XP e Windows 2000.
IDL
HttpRequest.idl

Confira também

IWinHttpRequest

Versões do WinHTTP