iWMDMMetaData::QueryByName 方法 (mswmdm.h)
QueryByName 方法检索由 name 指定的属性的值。
语法
HRESULT QueryByName(
[in] LPCWSTR pwszTagName,
[out] WMDM_TAG_DATATYPE *pType,
[out] BYTE **pValue,
[out] UINT *pcbLength
);
参数
[in] pwszTagName
指向以 null 结尾的宽字符字符串的指针,该字符串指定属性名称。 元数据常量中提供了标准属性名称 常量的列表。
[out] pType
一个WMDM_TAG_DATATYPE枚举值,用于描述 pValue 检索到的数据类型。
[out] pValue
指向字节数组的指针的指针,如果方法成功,该字节数组接收值的内容。 Windows Media 设备管理器分配此内存,调用方必须使用 CoTaskMemFree 释放它。
[out] pcbLength
指向字节数组 ppValue 的大小(以字节为单位)的指针。 如果值为字符串,则包括终止字符。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |