IMFHttpDownloadRequest::QueryHeader メソッド (mfidl.h)

  • [アーティクル]

以前に送信された HTTP または HTTPS 要求への応答から指定された HTTP ヘッダーの値を取得するために、Microsoft Media Foundation によって呼び出されます。 Media Foundation は、 EndReceiveResponse メソッドを正常に呼び出した後にのみ、このメソッドを呼び出します。

構文

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

パラメーター

[in] szHeaderName

値のクエリ対象となる HTTP ヘッダーの名前。

[in] dwIndex

応答に同じ名前の複数のヘッダーが含まれている場合の、指定したヘッダーのインデックス番号。 値 0 は、指定した名前の最初のヘッダーの値が要求されたことを示し、1 は 2 番目のヘッダーが要求されたことを示します。

[out] ppszHeaderValue

復帰文字や改行文字を含まない、要求されたヘッダーの値に設定します。 ppszHeaderValue のメモリは CoTaskMemAlloc で割り当てる必要があり、CoTaskMemFree を使用して Media Foundation によって解放されます。

戻り値

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

リターン コード 説明
S_OK
 指定したインデックスを持つ指定したヘッダーの値が正常に返されました。
E_OUTOFMEMORY
 操作を完了するためのメモリが不足しています。
E_POINTER
 ppszHeaderValue パラメーターが無効なポインターです。
MF_E_OUT_OF_RANGE
 dwIndex パラメーターの値が範囲外です。

要件

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

関連項目

IMFHttpDownloadRequest