IWICMetadataWriter::SetValueByIndex-Methode (wincodecsdk.h)

Legt das Metadatenelement auf den angegebenen Index fest.

Syntax

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

Parameter

[in] nIndex

Typ: UINT

Der Index zum Platzieren des Metadatenelements.

[in] pvarSchema

Typ: const PROPVARIANT*

Zeiger auf die Schemaeigenschaft des Metadatenelements.

[in] pvarId

Typ: const PROPVARIANT*

Zeiger auf die ID-Eigenschaft des Metadatenelements.

[in] pvarValue

Typ: const PROPVARIANT*

Zeiger auf den Metadatenwert, der für den angegebenen Index festgelegt werden soll.

Rückgabewert

Typ: HRESULT

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

Hinweise

Nach dem Entfernen eines Elements erwarten Sie, dass die verbleibenden Metadatenelemente nach oben verschoben werden, um den Speicherort des leerstehenden Metadatenelements zu belegen. Daher ändern sich die Indizes für verbleibende Metadatenelemente sowie die Anzahl.

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	wincodecsdk.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll