Метод IMFHttpDownloadRequest::QueryHeader (mfidl.h)

Статья
08/24/2023

Вызывается Microsoft Media Foundation для получения значений указанных заголовков HTTP из ответа на ранее отправленный ЗАПРОС HTTP или HTTPS. Media Foundation вызывает этот метод только после успешного вызова метода EndReceiveResponse .

Синтаксис

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

Параметры

[in] szHeaderName

Имя заголовка HTTP, для которого запрашивается значение.

[in] dwIndex

Номер индекса указанного заголовка для случая, когда ответ содержит несколько заголовков с одинаковым именем. Значение 0 указывает, что запрашивается значение первого заголовка с указанным именем, 1 указывает, что запрашивается второй заголовок и т. д.

[out] ppszHeaderValue

Задайте значение запрошенного заголовка, не включая символы возврата каретки или перевода строки. Память для ppszHeaderValue должна быть выделена с помощью CoTaskMemAlloc и освобождена Media Foundation с CoTaskMemFree.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Успешно возвращено значение указанного заголовка с указанным индексом.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
E_POINTER	Параметр ppszHeaderValue является недопустимым указателем.
MF_E_OUT_OF_RANGE	Значение параметра dwIndex выходит за пределы диапазона.

Требования


Минимальная версия клиента	Windows 10 версии 1703 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	mfidl.h
Библиотека	Mfplat.lib; Mfplat.dll

См. также раздел

IMFHttpDownloadRequest

Поделиться через