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