Método IWICMetadataQueryWriter::SetMetadataByName (wincodec.h)

Artículo
03/03/2024

Establece un elemento de metadatos en una ubicación específica.

Sintaxis

HRESULT SetMetadataByName(
  [in] LPCWSTR           wzName,
  [in] const PROPVARIANT *pvarValue
);

Parámetros

[in] wzName

Tipo: LPCWSTR

Nombre del elemento de metadatos.

[in] pvarValue

Tipo: const PROPVARIANT*

Metadatos que se van a establecer.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

SetMetadataByName usa expresiones de consulta de metadatos para quitar metadatos. Para obtener más información sobre el lenguaje de consulta de metadatos, consulte Información general sobre el lenguaje de consulta de metadatos.

Si el conjunto de valores es un bloque de metadatos anidado, use el tipo VT_UNKNOWN de variante y pvarValue que apunte a IWICMetadataQueryWriter del nuevo bloque de metadatos.
El orden de los elementos de metadatos es a discreción del escritor de consultas, ya que no se especifican ubicaciones relativas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, 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	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll