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

Microsoft Media Foundation によって呼び出され、以前に送信された HTTP または HTTPS 要求への応答から指定された HTTP ヘッダーの値を取得します。 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 パラメーター値が範囲外です。

必要条件

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

こちらも参照ください

IMFHttpDownloadRequest を する

  • Last updated on