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

Recupera el valor asociado a una clave.

Sintaxis

HRESULT GetItem(
  [in]      REFGUID     guidKey,
  [in, out] PROPVARIANT *pValue
);

Parámetros

[in] guidKey

GUID que identifica qué valor se va a recuperar.

[in, out] pValue

Puntero a un PROPVARIANT que recibe el valor. El método rellena el PROPVARIANT con una copia del valor almacenado, si se encuentra el valor. Llame a PropVariantClear para liberar la memoria asignada por este método. Este parámetro puede ser NULL. Si este parámetro es NULL, el método busca la clave y devuelve S_OK si se encuentra la clave, pero no copia el valor.

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.
MF_E_ATTRIBUTENOTFOUND	No se encontró la clave especificada.

Comentarios

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) instalados.

Ejemplos

En el ejemplo siguiente se copia un atributo de un almacén de atributos a otro.

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

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