Objeto WinHttpRequest

Este tópico fornece informações sobre como usar o objeto WINHTTP WinHttpRequest COM com linguagens de script. Para obter mais informações, incluindo a API do C++ (WinHTTP), consulte Sobre o WinHTTP. Consulte Escolhendo uma interface WinHTTP para obter 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 estes tipos de membros:

• Eventos
• Métodos
• Propriedades

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
Anular	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 com 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, seja 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 individuais de tempo limite de uma operação de envio/recebimento.
WaitForResponse	Especifica o tempo de espera, em segundos, para que um método Send 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 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 em 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 no Windows XP e Windows 2000.
IDL	HttpRequest.idl
Biblioteca	Winhttp.lib
DLL	Winhttp.dll

Confira também

Versões do WinHTTP