IWICMetadataQueryWriter::SetMetadataByName-Methode (wincodec.h)

Artikel
03/06/2024

Legt ein Metadatenelement auf einen bestimmten Speicherort fest.

Syntax

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

Parameter

[in] wzName

Typ: LPCWSTR

Der Name des Metadatenelements.

[in] pvarValue

Typ: const PROPVARIANT*

Die festzulegenden Metadaten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

SetMetadataByName verwendet Metadatenabfrageausdrücke, um Metadaten zu entfernen. Weitere Informationen zur Metadatenabfragesprache finden Sie in der Übersicht über die Metadatenabfragesprache.

Wenn der Wertsatz ein geschachtelter Metadatenblock ist, verwenden Sie variant type VT_UNKNOWN und pvarValue , die auf den IWICMetadataQueryWriter des neuen Metadatenblocks verweisen.
Die Reihenfolge von Metadatenelementen liegt im Ermessen des Abfrageschreibers, da relative Speicherorte nicht angegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll