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

  • Artigo

Adiciona um valor de atributo com uma chave especificada.

Sintaxe

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Parâmetros

[in] guidKey

Um GUID que identifica o valor a ser definido. Se essa chave já existir, o método substituirá o valor antigo.

[in] Value

Um PROPVARIANT que contém o valor do atributo. O método copia o valor. O tipo PROPVARIANT deve ser um dos tipos listados na enumeração MF_ATTRIBUTE_TYPE .

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.
E_OUTOFMEMORY
 Memória insuficiente.
MF_E_INVALIDTYPE
 Tipo de atributo inválido.

Comentários

Esse método verifica se o tipo PROPVARIANT é um dos tipos de atributo definidos em MF_ATTRIBUTE_TYPE e falha se um tipo sem suporte é usado. No entanto, esse método não marcar se PROPVARIANT é o tipo correto para o GUID do atributo especificado. (Não há nenhuma maneira programática de associar GUIDs de atributo a tipos de propriedade.) Para obter uma lista de atributos do Media Foundation e seus tipos de dados, consulte Atributos do Media Foundation.

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 (include Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

Atributos e propriedades

IMFAttributes