SetColorProfileElementReference 函数 (icm.h)

在指定的 ICC 颜色配置文件中创建引用与现有标记相同的数据的新标记。

语法

BOOL SetColorProfileElementReference(
  HPROFILE hProfile,
  TAGTYPE  newTag,
  TAGTYPE  refTag
);

parameters

hProfile

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

newTag

标识要创建的新标记。

refTag

标识新标记将引用其数据的现有标记。

返回值

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

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

注解

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

如果 newTag 已存在或 refTag 不存在， SetColorProfileElementReference 将 失败。

如果未使用读/写权限打开颜色配置文件， SetColorProfileElementReference 将失败。

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

要求

另请参阅

• 基本颜色管理概念
• 函数