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
Library Windowscodecs.lib
DLL Windowscodecs.dll

请参阅

概念性

IWICMetadataQueryReader

元数据查询语言概述

其他资源

读取和写入图像元数据概述

PROPVARIANT

WIC 元数据概述