Método IMFHttpDownloadRequest::QueryHeader (mfidl.h)

Invocado por Microsoft Media Foundation para recuperar os valores de 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 de 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 para ppszHeaderValue deve ser alocada com CoTaskMemAlloc e será liberada pela Media Foundation com CoTaskMemFree.

Valor de retorno

O método retorna umHRESULT . Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Requisitos

Consulte também

IMFHttpDownloadRequest