IWICMetadataQueryReader::GetLocation 方法 (wincodec.h)

检索相对于根元数据块的当前路径。

语法

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

参数

[in] cchMaxLength

类型: UINT

wzNamespace 缓冲区的长度。

[in, out] wzNamespace

类型: WCHAR*

接收当前命名空间位置的指针。

[out] pcchActualLength

类型: UINT*

检索当前命名空间位置所需的实际缓冲区长度。

返回值

类型: HRESULT

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

注解

如果将 NULL 传递给 wzNamespaceGetLocation 将忽略 cchMaxLength 并返回所需的缓冲区长度,以将路径存储在 pcchActualLength 指向的变量中。

如果查询读取器相对于元数据层次结构的顶部,它将返回单字符字符串。

如果查询读取器相对于嵌套元数据块,此方法将返回当前查询读取器的路径。

要求

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

请参阅

概念性

IWICMetadataQueryReader

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

WIC 元数据概述