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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
已成功返回具有指定索引的指定标头的值。 |
|
内存不足,无法完成操作。 |
|
ppszHeaderValue 参数是无效的指针。 |
|
dwIndex 参数值在范围外。 |
要求
最低受支持的客户端 | Windows 10版本 1703 [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mfidl.h |
Library | Mfplat.lib;Mfplat.dll |