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

  • Artigo

Consulta se um valor de atributo armazenado é igual a um PROPVARIANT especificado.

Sintaxe

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

Parâmetros

[in] guidKey

GUID que identifica qual valor consultar.

[in] Value

PROPVARIANT que contém o valor a ser comparado.

[out] pbResult

Recebe um valor booliano que indica se o atributo corresponde ao valor fornecido em Value. Consulte Observações. Esse parâmetro não deve ser NULL. Se esse parâmetro for NULL, ocorrerá uma violação de acesso.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.

Comentários

O método define pbResult como FALSE por qualquer um dos seguintes motivos:

  • Nenhum atributo é encontrado cuja chave corresponde à fornecida em guidKey.
  • O tipo PROPVARIANT do atributo não corresponde ao tipo fornecido em Value.
  • O valor do atributo não corresponde ao valor fornecido em Valor.
  • O método falha.
Caso contrário, o método define pbResult como TRUE.

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

Atributos e propriedades

IMFAttributes