Método IXMLHTTPRequest2::GetResponseHeader (msxml6.h)

Artigo
03/05/2024

Recupera o valor de um cabeçalho HTTP dos cabeçalhos de resposta.

Sintaxe

HRESULT GetResponseHeader(
  [in]            const WCHAR *pwszHeader,
  [out, optional] WCHAR       **ppwszValue
);

Parâmetros

[in] pwszHeader

Um nome de cabeçalho que não diferencia maiúsculas de minúsculas.

[out, optional] ppwszValue

As informações de cabeçalho resultantes. Você deve liberar a memória para esse parâmetro chamando a função CoTaskMemFree .

Retornar valor

Retornará S_OK se houver êxito.

Comentários

Os resultados desse método são válidos somente depois que o método de retorno de chamada OnHeadersAvailable for chamado.

Exemplos

HRESULT hr = S_OK;
WCHAR *pwszHeaderValue = NULL;
IXMLHTTPRequest2 *pIXMLHTTPRequest2 = NULL;

// Create XMLHTTPRequest2 object and initialize pIXMLHTTP2Request.
hr = pIXMLHTTPRequest2->GetResponseHeader(L"Server", &pwszHeaderValue);
if(SUCCEEDED(hr))
{
   MessageBox(NULL, pwszHeaderValue, L"Response Header-Server", MB_OK);   
}   

if (pwszHeaderValue != NULL)
{
   CoTaskMemFree(pwszHeaderValue);
   pwszHeaderValue = NULL;
}

// Release pIXMLHTTPRequest2 when finished with it.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP], MSXML 6.0 e posterior
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msxml6.h