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 错误代码。

注解

删除项后，预期剩余的元数据项将向上移动，以占用已空的元数据项位置。 因此，剩余元数据项的索引以及计数将更改。

要求

要求	值
最低受支持的客户端	Windows XP SP2，Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 | UWP 应用]
目标平台	Windows
标头	wincodecsdk.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll