Méthode IMFAttributes ::CompareItem (mfobjects.h)

  • Article

Interroge si une valeur d’attribut stockée est égale à un PROPVARIANT spécifié.

Syntaxe

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

Paramètres

[in] guidKey

GUID qui identifie la valeur à interroger.

[in] Value

PROPVARIANT qui contient la valeur à comparer.

[out] pbResult

Reçoit une valeur booléenne indiquant si l’attribut correspond à la valeur donnée dans Valeur. Consultez la section Notes. Ce paramètre ne doit pas avoir la valeur NULL. Si ce paramètre a la valeur NULL, une violation d’accès se produit.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK

Remarques

La méthode définit pbResult sur FALSE pour l’une des raisons suivantes :

  • Aucun attribut dont la clé correspond à celle donnée dans guidKey n’est trouvé.
  • Le type PROPVARIANT de l’attribut ne correspond pas au type donné dans Valeur.
  • La valeur de l’attribut ne correspond pas à la valeur donnée dans Valeur.
  • La méthode échoue.
Sinon, la méthode définit pbResult surTRUE.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfobjects.h (inclure Mfidl.h)
Bibliothèque Mfuuid.lib

Voir aussi

Attributs et propriétés

IMFAttributes