iWMDMMetaData::QueryByIndex 方法 (mswmdm.h)

QueryByIndex 方法检索 index 指定的属性的值。

语法

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

参数

[in] iIndex

指定属性从零开始的索引的整数。 项数是通过 GetItemCount 调用获取的。

[out] ppwszName

属性的名称。 Windows Media 设备管理器分配此内存,调用方必须使用 CoTaskMemFree 释放它。

[out] pType

描述 ppValue 中返回的数据类型的WMDM_TAG_DATATYPE枚举值。

[out] ppValue

指向字节数组的指针的指针,如果方法成功,该字节数组接收值的内容。 此内存由 Windows Media 设备管理器分配,调用方必须使用 CoTaskMemFree 释放它。

[out] pcbLength

指向字节数组 ppValue 的大小(以字节为单位)的指针。 如果值为字符串,则包括终止字符。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

GetItemCount

IWMDMMetaData 接口

QueryByName

设置文件的元数据