共用方式為


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 表示要求第二個標頭,依此類傳。

[out] ppszHeaderValue

設定為要求標頭的值,不包括歸位字元或換行字元。 ppszHeaderValue的記憶體必須以CoTaskMemAlloc配置,並由 Media Foundation 搭配CoTaskMemFree釋出。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
已成功傳回具有指定索引之指定標頭的值。
E_OUTOFMEMORY
記憶體不足,無法完成作業。
E_POINTER
ppszHeaderValue參數是不正確指標。
MF_E_OUT_OF_RANGE
dwIndex參數值超出範圍。

需求

   
最低支援的用戶端 Windows 10版本 1703 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mfidl.h
程式庫 Mfplat.lib;Mfplat.dll

另請參閱

IMFHttpDownloadRequest