IMFHttpDownloadSessionProvider::CreateHttpDownloadSession メソッド (mfidl.h)

Microsoft Media Foundation によって呼び出され、既定の実装を使用する代わりに HTTP または HTTPS URL を開きます。

構文

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

パラメーター

[in] wszScheme

IMFHttpDownloadSession が要求されるプロトコルの名前。 Microsoft Media Foundation は、アプリケーションが Media Foundation Source Resolver を提供した URL のプロトコル スキームを指定します。 有効な値には、HTTP の場合は "http"、HTTPS の場合は "https" が含まれます。 通常、URL スキーム名では大文字と小文字は区別されません。

[out] ppDownloadSession

正常に実行されると、パラメーターは IMFHttpDownloadSession インターフェイスへのポインターに設定されます。 返されたインターフェイスは、1 つの HTTP または HTTPS URL を開くために Microsoft Media Foundation によって使用されます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	IMFHttpDownloadSession オブジェクトが正常に作成されました。
E_INVALIDARG	wszScheme パラメーターに指定された値が正しくありません。
E_POINTER	ppDownloadSession パラメーターは無効なポインターです。
E_OUTOFMEMORY	操作を完了するためのメモリが不足しています。

解説

wszScheme の値として "https" を指定しても、IMFhttpDownloadSession::CreateRequest で要求ごとに指定されているように、HTTPS が特定の要求に使用されることを意味するものではありません。

要件

サポートされている最小のクライアント	Windows 10、バージョン 1703 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfplat.lib;Mfplat.dll

関連項目

IMFHttpDownloadSessionProvider