Método IWinHttpRequest::GetResponseHeader
O método GetResponseHeader recupera os cabeçalhos de resposta HTTP.
Sintaxe
HRESULT GetResponseHeader(
[in] BSTR Header,
[out, retval] BSTR *Value
);
Parâmetros
-
Cabeçalho [in]
-
Especifica o nome do cabeçalho que não diferencia maiúsculas de minúsculas.
-
Valor [out, retval]
-
Recebe as informações de cabeçalho resultantes.
Valor retornado
O valor retornado é S_OK com êxito ou um valor de erro, caso contrário.
Comentários
Esse método retorna o valor do cabeçalho de resposta chamado em Cabeçalho. Lembre-se de que os clientes de automação, como o script, obtêm os dados de cabeçalho como o valor retornado da chamada de função, não por meio de um parâmetro de função. Invoque esse método somente depois que o método Send tiver sido chamado.
Observação
Para Windows XP e Windows 2000, consulte a seção Requisitos de tempo de execução da Página Inicial do WinHTTP.
Exemplos
O exemplo a seguir mostra como abrir uma conexão HTTP, enviar uma solicitação HTTP e obter o cabeçalho de data da resposta. Este exemplo deve ser executado em um prompt de comando.
#include <windows.h>
#include <stdio.h>
#include <objbase.h>
#include "httprequest.h"
#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "oleaut32.lib")
// IID for IWinHttpRequest.
const IID IID_IWinHttpRequest =
{
0x06f29373,
0x5c5a,
0x4b54,
{0xb0, 0x25, 0x6e, 0xf1, 0xbf, 0x8a, 0xbf, 0x0e}
};
int main()
{
// Variable for return value
HRESULT hr;
// Initialize COM
hr = CoInitialize( NULL );
IWinHttpRequest * pIWinHttpRequest = NULL;
BSTR bstrResponse = NULL;
VARIANT varFalse;
VARIANT varEmpty;
CLSID clsid;
VariantInit(&varFalse);
V_VT(&varFalse) = VT_BOOL;
V_BOOL(&varFalse) = VARIANT_FALSE;
VariantInit(&varEmpty);
V_VT(&varEmpty) = VT_ERROR;
hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1",
&clsid);
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(clsid,
NULL,
CLSCTX_INPROC_SERVER,
IID_IWinHttpRequest,
(void **)&pIWinHttpRequest);
}
if (SUCCEEDED(hr))
{
// Open WinHttpRequest.
BSTR bstrMethod = SysAllocString(L"GET");
BSTR bstrUrl = SysAllocString(L"https://microsoft.com");
hr = pIWinHttpRequest->Open(bstrMethod,
bstrUrl,
varFalse);
SysFreeString(bstrMethod);
SysFreeString(bstrUrl);
}
if (SUCCEEDED(hr))
{
// Send Request.
hr = pIWinHttpRequest->Send(varEmpty);
}
if (SUCCEEDED(hr))
{
// Get Response text.
BSTR bstrName = SysAllocString(L"Date");
hr = pIWinHttpRequest->GetResponseHeader(bstrName,
&bstrResponse);
}
if (SUCCEEDED(hr))
{
// Print response to console.
wprintf(L"%.256s",bstrResponse);
}
// Release memory.
if (pIWinHttpRequest)
pIWinHttpRequest->Release();
if (bstrResponse)
SysFreeString(bstrResponse);
CoUninitialize();
return 0;
}
O exemplo de script a seguir mostra como abrir uma conexão HTTP, enviar uma solicitação HTTP e obter o cabeçalho de data da resposta.
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Initialize an HTTP request.
WinHttpReq.Open("GET",
"https://www.microsoft.com",
false);
// Send the HTTP request.
WinHttpReq.Send();
// Display the date header.
WScript.Echo( WinHttpReq.GetResponseHeader("Date"));
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 |
|