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

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

構文

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