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

  • Artículo

Agrega un valor de atributo con una clave especificada.

Sintaxis

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

Parámetros

[in] guidKey

GUID que identifica el valor que se va a establecer. Si esta clave ya existe, el método sobrescribe el valor anterior.

[in] Value

PROPVARIANT que contiene el valor del atributo. El método copia el valor. El tipo PROPVARIANT debe ser uno de los tipos enumerados en la enumeración MF_ATTRIBUTE_TYPE .

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_OUTOFMEMORY
 Memoria insuficiente.
MF_E_INVALIDTYPE
 Tipo de atributo no válido.

Comentarios

Este método comprueba si el tipo PROPVARIANT es uno de los tipos de atributo definidos en MF_ATTRIBUTE_TYPE y produce un error si se usa un tipo no admitido. Sin embargo, este método no comprueba si PROPVARIANT es el tipo correcto para el GUID de atributo especificado. (No hay ninguna manera programática de asociar GUID de atributo con tipos de propiedad). Para obtener una lista de los atributos de Media Foundation y sus tipos de datos, consulte Atributos de Media Foundation.

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.

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