IWICMetadataQueryReader：：GetMetadataByName 方法 (wincodec.h)
擷取元數據查詢表達式所識別的元數據區塊或專案。
語法
HRESULT GetMetadataByName(
[in] LPCWSTR wzName,
[in, out] PROPVARIANT *pvarValue
);
參數
[in] wzName
類型： LPCWSTR
所要求元數據區塊或專案的查詢表達式。
[in, out] pvarValue
類型： PROPVARIANT*
當這個方法傳回時，會包含要求的元數據區塊或專案。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
GetMetadataByName 會使用元數據查詢表達式來存取內嵌元數據。 如需元數據查詢語言的詳細資訊，請參閱 元數據查詢語言概觀。
如果存在多個以相同查詢表達式表示的區塊或專案，則會傳回第一個找到的元數據區塊或專案。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincodec.h |
| 程式庫 | Windowscodecs.lib |
| Dll | Windowscodecs.dll |
另請參閱
概念
其他資源