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 會使用元數據查詢表達式來移除元數據。如需元數據查詢語言的詳細資訊，請參閱元數據查詢語言概觀。

如果值集是巢狀元數據區塊，則使用 variant 類型和 VT_UNKNOWNpvarValue 指向新元數據區塊的 IWICMetadataQueryWriter 。
元數據專案的排序是由查詢寫入器決定，因為未指定相對位置。

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib
Dll	Windowscodecs.dll