Compartilhar via

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

  • Artigo

Recupera um atributo no índice especificado.

Sintaxe

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

Parâmetros

[in] unIndex

Índice do atributo a ser recuperado. Para obter o número de atributos, chame IMFAttributes::GetCount.

[out] pguidKey

Recebe o GUID que identifica esse atributo.

[in, out] pValue

Ponteiro para um PROPVARIANT que recebe o valor. Este parâmetro pode ser NULL. Se não for NULL, o método preencherá o PROPVARIANT com uma cópia do valor do atributo. Chame PropVariantClear para liberar a memória alocada por esse método.

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_INVALIDARG
 Índice inválido.

Comentários

Para enumerar todos os atributos de um objeto de maneira thread-safe, faça o seguinte:

  1. Chame IMFAttributes::LockStore para impedir que outro thread adicione ou exclua atributos.
  2. Chame IMFAttributes::GetCount para localizar o número de atributos.
  3. Chame GetItemByIndex para obter cada atributo por índice.
  4. Chame IMFAttributes::UnlockStore para desbloquear o repositório de atributos.
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