Поделиться через

Функция 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 + *pcbSize больше размера указанного элемента, эта функция записывает только столько байтов, сколько будет соответствовать текущему размеру элемента.

Все существующие данные в указанной части помеченного элемента перезаписываются при успешном выполнении этой функции.

Эта функция не поддерживает профили WINDOWS Color System (WCS) CAMP, DMP и GMMP; поскольку элементы профиля неявно связаны с типами тегов ICC и жестко закодируются в них, и существует множество надежных библиотек синтаксического анализа XML.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

См. также раздел