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

另请参阅

IWMDMMetaData 接口

元数据常量

QueryByIndex

设置文件的元数据