Método IMFHttpDownloadRequest::QueryHeader (mfidl.h)
Invocado pelo Microsoft Media Foundation para recuperar os valores dos cabeçalhos HTTP especificados da resposta a uma solicitação HTTP ou HTTPS enviada anteriormente. O Media Foundation invoca esse método somente depois de ter invocado com êxito o método EndReceiveResponse .
Sintaxe
HRESULT QueryHeader(
[in] LPCWSTR szHeaderName,
[in] DWORD dwIndex,
[out] LPWSTR *ppszHeaderValue
);
Parâmetros
[in] szHeaderName
O nome do cabeçalho HTTP para o qual o valor está sendo consultado.
[in] dwIndex
O número de índice do cabeçalho especificado, para o caso em que a resposta contém vários cabeçalhos com o mesmo nome. Um valor 0 indica que o valor do primeiro cabeçalho com o nome especificado é solicitado, 1 indica que o segundo cabeçalho é solicitado e assim por diante.
[out] ppszHeaderValue
Defina como o valor do cabeçalho solicitado, não incluindo os caracteres de retorno de carro ou feed de linha. A memória de ppszHeaderValue deve ser alocada com CoTaskMemAlloc e será liberada pela Media Foundation com CoTaskMemFree.
Valor retornado
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
Retornou com êxito o valor do cabeçalho especificado com o índice especificado. |
|
Não há memória suficiente para concluir a operação. |
|
O parâmetro ppszHeaderValue é um ponteiro inválido. |
|
O valor do parâmetro dwIndex está fora do intervalo. |
Requisitos
| Cliente mínimo com suporte | Windows 10, versão 1703 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mfidl.h |
| Biblioteca | Mfplat.lib; Mfplat.dll |