IMFAttributes::CompareItem-Methode (mfobjects.h)

  • Artikel

Fragt ab, ob ein gespeicherter Attributwert einem angegebenen PROPVARIANT entspricht.

Syntax

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

Parameter

[in] guidKey

GUID, die den abzufragenden Wert identifiziert.

[in] Value

PROPVARIANT , der den zu vergleichenden Wert enthält.

[out] pbResult

Empfängt einen booleschen Wert, der angibt, ob das Attribut mit dem in Value angegebenen Wert übereinstimmt. Siehe Hinweise. Dieser Parameter darf nicht NULL sein. Wenn dieser Parameter NULL ist, tritt eine Zugriffsverletzung auf.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.

Hinweise

Die -Methode legt pbResult aus einem der folgenden Gründe auf FALSE fest:

  • Es wird kein Attribut gefunden, dessen Schlüssel mit dem in guidKey angegebenen übereinstimmt.
  • Der PROPVARIANT-Typ des Attributs stimmt nicht mit dem in Value angegebenen Typ überein.
  • Der Attributwert stimmt nicht mit dem in Value angegebenen Wert überein.
  • Die -Methode schlägt fehl.
Andernfalls legt die Methode pbResult auf TRUE fest.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

Attribute und Eigenschaften

IMFAttributes