Partager via

Méthode IWICMetadataWriter ::SetValueByIndex (wincodecsdk.h)

  • Article

Définit l’élément de métadonnées sur l’index spécifié.

Syntaxe

HRESULT SetValueByIndex(
  [in] UINT              nIndex,
  [in] const PROPVARIANT *pvarSchema,
  [in] const PROPVARIANT *pvarId,
  [in] const PROPVARIANT *pvarValue
);

Paramètres

[in] nIndex

Type : UINT

Index pour placer l’élément de métadonnées.

[in] pvarSchema

Type : const PROPVARIANT*

Pointeur vers la propriété de schéma de l’élément de métadonnées.

[in] pvarId

Type : const PROPVARIANT*

Pointeur vers la propriété id de l’élément de métadonnées.

[in] pvarValue

Type : const PROPVARIANT*

Pointeur vers la valeur de métadonnées à définir à l’index donné.

Valeur retournée

Type : HRESULT

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

Remarques

Après avoir supprimé un élément, attendez-vous à ce que les éléments de métadonnées restants se déplacent vers le haut pour occuper l’emplacement de l’élément de métadonnées libéré. Par conséquent, les index des éléments de métadonnées restants ainsi que le nombre changeront.

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 wincodecsdk.h
Bibliothèque Windowscodecs.lib
DLL Windowscodecs.dll