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

  • Artículo

Consulta si un valor de atributo almacenado es igual a un PROPVARIANT especificado.

Sintaxis

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

Parámetros

[in] guidKey

GUID que identifica qué valor se va a consultar.

[in] Value

PROPVARIANT que contiene el valor que se va a comparar.

[out] pbResult

Recibe un valor booleano que indica si el atributo coincide con el valor especificado en Value. Vea la sección Comentarios. Este parámetro no debe ser NULL. Si este parámetro es NULL, se produce una infracción de acceso.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.

Comentarios

El método establece pbResult en FALSE por cualquiera de los siguientes motivos:

  • No se encuentra ningún atributo cuya clave coincide con la especificada en guidKey.
  • El tipo PROPVARIANT del atributo no coincide con el tipo especificado en Value.
  • El valor del atributo no coincide con el valor especificado en Value.
  • Se produce un error en el método .
De lo contrario, el método establece pbResult en TRUE.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

Atributos y propiedades

IMFAttributes