IWICMetadataQueryWriter：：SetMetadataByName 方法 (wincodec.h)

将元数据项设置为特定位置。

语法

HRESULT SetMetadataByName(
  [in] LPCWSTR           wzName,
  [in] const PROPVARIANT *pvarValue
);

[in] wzName

类型： LPCWSTR

元数据项的名称。

[in] pvarValue

类型： const PROPVARIANT*

要设置的元数据。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

SetMetadataByName 使用元数据查询表达式删除元数据。有关元数据查询语言的详细信息，请参阅元数据查询语言概述。

如果设置的值是嵌套元数据块，则使用变体类型和 VT_UNKNOWNpvarValue 指向新元数据块的 IWICMetadataQueryWriter 。
元数据项的排序由查询编写器自行决定，因为未指定相对位置。

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