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 に設定します。

それ以外の場合、メソッドは pbResult を TRUE に設定 します。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

Windows XP 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