IMFAttributes：：CompareItem 方法 (mfobjects.h)

  • 项目

查询存储的属性值是否等于指定的 PROPVARIANT。

语法

HRESULT CompareItem(
  [in]  REFGUID        guidKey,
  [in]  REFPROPVARIANT Value,
  [out] BOOL           *pbResult
);

参数

[in] guidKey

标识要查询的值的 GUID。

[in] Value

包含要比较的值的 PROPVARIANT。

[out] pbResult

接收一个布尔值，该值指示属性是否与 Value 中给定的值匹配。 请参阅“备注”。 此参数不得为 NULL。 如果此参数为 NULL，则会发生访问冲突。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。

注解

方法出于以下任一原因将 pbResult 设置为 FALSE ：

  • 找不到其键与 guidKey 中给定的属性匹配的属性。
  • 特性的 PROPVARIANT 类型与 Value 中给定的类型不匹配。
  • 属性值与 Value 中给定的值不匹配。
  • 方法失败。
否则， 方法将 pbResult 设置为 TRUE。

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此接口在以下平台上可用：

  • Windows XP with Service Pack 2 (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (windows XP Media Center Edition 2005) 和KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新汇总) 安装。

要求

要求 值
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfobjects.h (包括 Mfidl.h)
Library Mfuuid.lib

另请参阅

特性和属性

IMFAttributes