WICMapSchemaToName 函数 (wincodec.h)

获取与给定架构关联的名称。

语法

HRESULT WICMapSchemaToName(
  [in]      REFGUID guidMetadataFormat,
  [in]      LPWSTR  pwzSchema,
  [in]      UINT    cchName,
  [in, out] WCHAR   *wzName,
  [out]     UINT    *pcchActual
);

参数

[in] guidMetadataFormat

类型： REFGUID

元数据格式 GUID。

[in] pwzSchema

类型： LPWSTR

要为其检索名称的架构的 URI 字符串。

[in] cchName

类型： UINT

wzName 缓冲区的大小。

[in, out] wzName

类型： WCHAR*

指向接收架构名称的缓冲区的指针。

若要获取所需的缓冲区大小，请调用将 cchName 设置为 0 且 wzName 设置为 NULL 的 WICMapSchemaToName。

[out] pcchActual

类型： UINT

检索整个架构名称所需的实际缓冲区大小。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

可以通过将 添加到以下注册表项来扩展架构名称映射：

HKEY_CLASSES_ROOT
   CLSID
      {FAE3D380-FEA4-4623-8C75-C6B61110B681}
         Schemas
            BB5ACC38-F216-4CEC-A6C5-5F6E739763A9
               ...

有关详细信息，请参阅 如何编写 WIC-Enabled 编解码器。

要求

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