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

Article
03/03/2024

Définit un élément de métadonnées à un emplacement spécifique.

Syntaxe

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

Paramètres

[in] wzName

Type : LPCWSTR

Nom de l’élément de métadonnées.

[in] pvarValue

Type : const PROPVARIANT*

Métadonnées à définir.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

SetMetadataByName utilise des expressions de requête de métadonnées pour supprimer les métadonnées. Pour plus d’informations sur le langage de requête de métadonnées, consultez Vue d’ensemble du langage de requête de métadonnées.

Si le jeu de valeurs est un bloc de métadonnées imbriqué, utilisez le type VT_UNKNOWN variant et pvarValue pointant vers IWICMetadataQueryWriter du nouveau bloc de métadonnées.
L’ordre des éléments de métadonnées est à la discrétion de l’enregistreur de requêtes, car les emplacements relatifs ne sont pas spécifiés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll