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

  • Статья

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

Синтаксис

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

Параметры

[in] wszScheme

Имя протокола, для которого запрашивается IMFHttpDownloadSession . Microsoft Media Foundation указывает схему протокола URL-адреса, который приложение предоставило сопоставитель источника Media Foundation. Допустимые значения: "http" для HTTP и "https" для HTTPS. В именах схем URL-адресов, как правило, регистр не учитывается.

[out] ppDownloadSession

При успешном выполнении параметру присваивается указатель на интерфейс IMFHttpDownloadSession . Возвращаемый интерфейс используется Microsoft 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
Библиотека Mfplat.lib; Mfplat.dll

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

IMFHttpDownloadSessionProvider