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
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 |
|
| Biblioteca |
|
| DLL |
|