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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
IMFHttpDownloadSession オブジェクトが正常に作成されました。 |
|
wszScheme パラメーターに指定された値が正しくありません。 |
|
ppDownloadSession パラメーターは無効なポインターです。 |
|
操作を完了するためのメモリが不足しています。 |
解説
wszScheme の値として "https" を指定しても、IMFhttpDownloadSession::CreateRequest で要求ごとに指定されているように、HTTPS が特定の要求に使用されることを意味するものではありません。
要件
サポートされている最小のクライアント | Windows 10、バージョン 1703 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | mfidl.h |
Library | Mfplat.lib;Mfplat.dll |