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

Recupera un atributo en el índice especificado.

Sintaxis

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

Parámetros

[in] unIndex

Índice del atributo que se va a recuperar. Para obtener el número de atributos, llame a IMFAttributes::GetCount.

[out] pguidKey

Recibe el GUID que identifica este atributo.

[in, out] pValue

Puntero a un PROPVARIANT que recibe el valor. Este parámetro puede ser NULL. Si no es NULL, el método rellena el PROPVARIANT con una copia del valor del atributo. Llame a PropVariantClear para liberar la memoria asignada por este método.

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.
E_INVALIDARG	Índice no válido.

Comentarios

Para enumerar todos los atributos de un objeto de forma segura para subprocesos, haga lo siguiente:

1. Llame a IMFAttributes::LockStore para evitar que otro subproceso agregue o elimine atributos.
2. Llame a IMFAttributes::GetCount para buscar el número de atributos.
3. Llame a GetItemByIndex para obtener cada atributo por índice.
4. Llame a IMFAttributes::UnlockStore para desbloquear el almacén de atributos.

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