GetColorProfileElementTag 函数 (icm.h)

检索给定国际颜色联盟的标记表中 dwIndex 指定的标记名称, (ICC) 颜色配置文件,其中 dwIndex 是该表中的一个从 1 开始的索引。

语法

BOOL GetColorProfileElementTag(
  HPROFILE hProfile,
  DWORD    dwIndex,
  PTAGTYPE pTag
);

parameters

hProfile

指定有问题的 ICC 颜色配置文件的句柄。

dwIndex

指定要检索的标记的从 1 开始的索引。

pTag

指向要在其中放置标记名称的变量的指针。

返回值

如果此函数成功,则返回值为 TRUE

如果此函数失败,则返回值为 FALSE。 有关扩展的错误信息,请调用 GetLastError

注解

如果 hProfile 不是有效的 ICC 配置文件,则此函数将失败。

使用 GetCountColorProfileElements 获取配置文件中的标记数后,GetColorProfileElementTag 可用于枚举配置文件中的所有标记。

此函数不支持 Windows 颜色系统 (WCS) 配置文件 CAMP、DMP 和 GMMP;因为配置文件元素与 ICC 标记类型隐式关联并对其进行硬编码,并且存在许多可靠的 XML 分析库。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅