setColorProfileElement 函数 (icm.h)

设置 ICC 颜色配置文件中标记的配置文件元素的元素数据。

语法

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

hProfile

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

tag

标识标记的元素。

dwOffset

指定要开始写入的标记元素数据的第一个字节的偏移量。

pcbElement

指向包含要写入的数据字节数的变量的指针。返回时，它包含实际写入的字节数。

pElement

指向缓冲区的指针，该缓冲区包含要写入颜色配置文件中标记元素的数据。

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

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

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

如果未打开颜色配置文件以获取读/写权限，则此函数将失败。

如果 dwOffset 超出指定标记元素设置的大小，则此函数将失败。

如果 dwOffset + *bsize 大于指定元素的大小，则此函数只写入元素当前大小的字节数。

当此函数成功时，将覆盖已标记元素的指定部分中的任何现有数据。

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

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