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