Partager via


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

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

Voir aussi

Conceptuel

Procédure : réencoder une image JPEG avec des métadonnées

IWICMetadataQueryWriter

Vue d’ensemble du langage de requête de métadonnées

Autres ressources

Vue d’ensemble de la lecture et de l’écriture de métadonnées d’image

PROPVARIANT

Vue d’ensemble des métadonnées WIC