IWICMetadataWriter：：SetValueByIndex 方法 (wincodecsdk.h)

將元數據項目設定為指定的索引。

語法

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

參數

[in] nIndex

類型： UINT

要放置元數據專案的索引。

[in] pvarSchema

類型： const PROPVARIANT*

元數據項目的架構屬性指標。

[in] pvarId

類型： const PROPVARIANT*

元數據專案的id屬性指標。

[in] pvarValue

類型： const PROPVARIANT*

要設定在指定索引處的元數據值的指標。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

拿掉項目之後，預期剩餘的元數據專案會向上移動，以佔用空的元數據專案位置。 因此，剩餘元數據專案的索引以及計數將會變更。

規格需求