Share via


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 版本 2005) 和 KB925766 (2006 年 10 月更新匯總) 。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (include Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

屬性和屬性

IMFAttributes