Метод IMFHttpDownloadSessionProvider::CreateHttpDownloadSession (mfidl.h)

Вызывается Майкрософт Media Foundation для открытия URL-адресов HTTP или HTTPS вместо использования реализации по умолчанию.

Синтаксис

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

Параметры

[in] wszScheme

Имя протокола, для которого запрашивается МВФHttpDownloadSession . Майкрософт Media Foundation указывает схему протокола URL-адреса, который приложение предоставило сопоставитель источника Media Foundation. Допустимые значения включают http для HTTP и https для HTTPS. Имена схем URL обычно не учитывает регистр.

[out] ppDownloadSession

При успешном выполнении параметр устанавливается на указатель на интерфейс МВФHttpDownloadSession . Возвращенный интерфейс используется Майкрософт Media Foundation для открытия одного URL-адреса HTTP или HTTPS.

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

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

Код возврата Описание
S_OK
 Успешно создан объект IMFHttpDownloadSession .
E_INVALIDARG
 Неверное значение, указанное для параметра wszScheme .
E_POINTER
 Параметр ppDownloadSession является недопустимым указателем.
E_OUTOFMEMORY
 Для завершения операции недостаточно памяти.

Замечания

Указание "https" в качестве значения wszScheme не означает, что HTTPS будет использоваться для конкретного запроса, так как это указано на основе каждого запроса в IMFhttpDownloadSession::CreateRequest.

Требования

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

См. также

МВФHttpDownloadSessionProvider

  • Последнее обновление: