IMFHttpDownloadRequest::QueryHeader 方法 (mfidl.h)

由 Microsoft Media Foundation 调用,以从对以前发送的 HTTP 或 HTTPS 请求的响应中检索指定 HTTP 标头的值。 Media Foundation 仅在成功调用 EndReceiveResponse 方法后才调用此方法。

语法

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

parameters

[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
Library Mfplat.lib;Mfplat.dll

另请参阅

IMFHttpDownloadRequest