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

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