检索给定国际颜色联盟的标记表中 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 |