IWICMetadataQueryReader::GetMetadataByName method (wincodec.h)
Retrieves the metadata block or item identified by a metadata query expression.
Syntax
HRESULT GetMetadataByName(
[in] LPCWSTR wzName,
[in, out] PROPVARIANT *pvarValue
);
Parameters
[in] wzName
Type: LPCWSTR
The query expression to the requested metadata block or item.
[in, out] pvarValue
Type: PROPVARIANT*
When this method returns, contains the metadata block or item requested.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
GetMetadataByName uses metadata query expressions to access embedded metadata. For more information on the metadata query language, see the Metadata Query Language Overview.
If multiple blocks or items exist that are expressed by the same query expression, the first metadata block or item found will be returned.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP2, Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | wincodec.h |
| Library | Windowscodecs.lib |
| DLL | Windowscodecs.dll |
See also
Conceptual
Metadata Query Language Overview
Other Resources