Objeto WinHttpRequest

Este tópico fornece informações sobre como usar o objeto WinHttpRequest COM do WinHTTP com linguagens de script. Para obter mais informações, incluindo a API do C++ (WinHTTP), consulte Sobre o WinHTTP. Consulte Como escolher uma interface WinHTTP para uma comparação dessas interfaces.

Exemplo

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

Exemplos de código obtidos da propriedade IWinHttpRequest::Status.

Membros

O objeto WinHttpRequest tem esses tipos de membros:

Eventos

O objeto WinHttpRequest tem esses eventos.

Evento 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.

Métodos

O objeto WinHttpRequest tem esses métodos.

Método Descrição
Abortar Anula um método WinHTTPSend.
Getallresponseheaders Recupera todos os cabeçalhos de resposta HTTP.
Getresponseheader Recupera os cabeçalhos de resposta HTTP.
Aberto Abre uma conexão HTTP para um recurso HTTP.
Enviar Envia uma solicitação HTTP para um servidor HTTP.
SetAutoLogonPolicy Define a política de logon automático atual.
SetClientCertificate Seleciona um certificado de cliente para enviar para um servidor HTTPS (Protocolo de Transferência de Hipertexto Seguro).
SetCredentials Define as credenciais a serem usadas com um servidor HTTP ou uma origem ou um servidor proxy.
SetProxy Define informações do servidor proxy.
SetRequestHeader Adiciona, altera ou exclui um cabeçalho de solicitação HTTP.
SetTimeouts Especifica, em milissegundos, os componentes de tempo limite individuais de uma operação de envio/recebimento.
WaitForResponse Especifica o tempo de espera, em segundos, para que um método de envio assíncrono seja concluído, com valor de tempo limite opcional.

Propriedades

O objeto WinHttpRequest tem essas propriedades.

Propriedade Tipo de acesso Descrição
Opção
Leitura/gravação
Define ou recupera um valor de opção WinHTTP.
ResponseBody
Somente leitura
Recupera o corpo da entidade de resposta como uma matriz de bytes não assinados.
ResponseStream
Somente leitura
Recupera o corpo da entidade de resposta como um IStream.
ResponseText
Somente leitura
Recupera o corpo da entidade de resposta como texto.
Status
Somente leitura
Recupera o código de status HTTP da última resposta.
Statustext
Somente leitura
Recupera o texto de status HTTP.

Comentários

O objeto WinHttpRequest usa a interface IErrorInfo para fornecer dados de erro. Uma descrição e um valor de erro numérico podem ser obtidos com o objeto Err no Microsoft Visual Basic Scripting Edition (VBScript) e o objeto Error no Microsoft JScript. Os 16 bits inferiores de um número de erro correspondem aos valores encontrados nas Mensagens de Erro.

Observação

Para Windows XP e Windows 2000, consulte Requisitos de Tempo de Execução.

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 em Windows XP e Windows 2000.
IDL
HttpRequest.idl
Biblioteca
Winhttp.lib
DLL
Winhttp.dll

Confira também

Versões do WinHTTP