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。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
已成功傳回具有指定索引之指定標頭的值。 |
|
記憶體不足,無法完成作業。 |
|
ppszHeaderValue參數是不正確指標。 |
|
dwIndex參數值超出範圍。 |
需求
最低支援的用戶端 | Windows 10版本 1703 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfplat.lib;Mfplat.dll |