Метод IMFHttpDownloadSession::CreateRequest (mfidl.h)

  • Статья

Вызывается Microsoft Media Foundation для создания объекта, реализующего интерфейс IMFHttpDownloadRequest , который используется для отправки одного http-запроса или HTTPS. Так как для полной загрузки ресурса может потребоваться несколько запросов, Media Foundation может вызывать CreateRequest несколько раз в одном экземпляре IMFHttpDownloadSession . Media Foundation будет использовать каждый экземпляр IMFHttpDownloadRequest только для одного запроса.

Синтаксис

HRESULT CreateRequest(
  [in]           LPCWSTR                szObjectName,
  [in]           BOOL                   fBypassProxyCache,
  [in]           BOOL                   fSecure,
  [in, optional] LPCWSTR                szVerb,
  [in, optional] LPCWSTR                szReferrer,
                 IMFHttpDownloadRequest **ppRequest
);

Параметры

[in] szObjectName

Указатель на строку, содержащую имя целевого ресурса указанной HTTP-команды. Обычно это имя файла, исполняемый модуль или описатель поиска. Целевой ресурс всегда начинается с символа косой черты и включает любую строку запроса, включенную в URL-адрес.

[in] fBypassProxyCache

Если задано значение TRUE, указывает, что запрос должен быть переадресован на исходный сервер, а не отправлять кэшированную версию ресурса с прокси-сервера. Если для этого флага задано значение TRUE, в запрос следует добавить заголовок Pragma: no-cache. При создании запроса HTTP/1.1 также следует добавить "Cache-Control: no-cache".

[in] fSecure

Если задано значение TRUE, вызывает использование безопасного варианта протокола, если применимо. Например, если IMFHttpDownloadSession имеет значение HTTP/HTTPS, при установке значения fSecure в значение TRUE запрос будет использовать HTTPS. В противном случае используется небезопасный вариант протокола (в данном примере HTTP).

[in, optional] szVerb

Указатель на строку, содержащую HTTP-команду, используемую в запросе. Если этот параметр имеет значение NULL, функция использует GET в качестве HTTP-команды.

Примечание Эта строка должна быть прописной. Многие серверы обрабатывают HTTP-команды как чувствительные к регистру, и запросы комментариев (RFC) целевой группы по интернет-инженерии (IETF) пишут эти команды только с использованием символов верхнего регистра.
 

[in, optional] szReferrer

Указатель на строку, указывающую URL-адрес документа, из которого получен URL-адрес в запросе szObjectName . Если для этого параметра задано значение NULL, ссылочный документ не указан.

ppRequest

При успешном возвращении метода этому параметру присваивается интерфейс IMFHttpDownloadRequest .

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

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

Код возврата Описание
S_OK
 Предоставленные сведения успешно сохранены.
E_OUTOFMEMORY
 Недостаточно памяти для завершения операции.
MF_E_INVALIDREQUEST
 Метод был вызван после закрытия или до вызова SetServer .

Требования

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

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

IMFHttpDownloadSession