IMFHttpDownloadSession::CreateRequest メソッド (mfidl.h)

Microsoft Media Foundation によって呼び出され、1 つの HTTP または HTTPS 要求の送信に使用される IMFHttpDownloadRequest インターフェイスを実装するオブジェクトを作成します。 リソースを完全にダウンロードするために複数の要求が必要な場合があるため、Media Foundation は同じ IMFHttpDownloadSession インスタンスで CreateRequest を複数回呼び出すことができます。 Media Foundation では、各 IMFHttpDownloadRequest インスタンスが 1 つの要求にのみ使用されます。

構文

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 の場合、関数は HTTP 動詞として GET を使用します。

[in, optional] szReferrer

要求 szObjectName の URL が取得されたドキュメントの URL を指定する文字列へのポインター。 このパラメーターが NULL に設定されている場合、参照ドキュメントは指定されません。

ppRequest

メソッドが正常に戻ると、このパラメーターは IMFHttpDownloadRequest インターフェイスに設定されます。

値を返す

このメソッドは、HRESULTを返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。

必要条件

こちらも参照ください

IMFHttpDownloadSession を する