Metodo IMFAttributes::CompareItem (mfobjects.h)

Articolo
08/24/2023

Esegue una query sul fatto che un valore di attributo archiviato sia uguale a un VALORE PROPVARIANT specificato.

Sintassi

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

Parametri

[in] guidKey

GUID che identifica il valore da eseguire per la query.

[in] Value

PROPVARIANT contenente il valore da confrontare.

[out] pbResult

Riceve un valore booleano che indica se l'attributo corrisponde al valore specificato in Valore. Vedere la sezione Osservazioni. Questo parametro non deve essere NULL. Se questo parametro è NULL, si verifica una violazione di accesso.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Il metodo imposta pbResult su FALSE per uno dei motivi seguenti:

Nessun attributo viene trovato la cui chiave corrisponde a quella specificata in guidKey.
Il tipo PROPVARIANT dell'attributo non corrisponde al tipo specificato in Value.
Il valore dell'attributo non corrisponde al valore specificato in Valore.
Il metodo ha esito negativo.

In caso contrario, il metodo imposta pbResult su TRUE.

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

Windows XP con Service Pack 2 (SP2) e versioni successive.
Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

Attributi e proprietà

FMAttributes

Condividi tramite