Функция UpdateICMRegKeyA (wingdi.h)

Статья
11/20/2024

(устаревшее; сохранено для обратной совместимости)

Функция UpdateICMRegKey управляет профилями цветов и модулями управления цветами в системе.

Синтаксис

BOOL UpdateICMRegKeyA(
  DWORD reserved,
  LPSTR lpszCMID,
  LPSTR lpszFileName,
  UINT  command
);

Параметры

reserved

Зарезервировано должно быть равно нулю.

lpszCMID

Указывает на строку, указывающую идентификатор профиля ICC для библиотеки DLL управления цветом, используемой с профилем.

lpszFileName

Указывает на полное имя файла профиля цвета ICC или на структуру DEVMODE.

command

Указывает функцию для выполнения. Он может иметь одно из следующих значений.

Ценность	Значение
ICM_ADDPROFILE	Устанавливает профиль ICC в системе.
ICM_DELETEPROFILE	Удаляет профиль ICC из системы, но не удаляет файл.
ICM_QUERYPROFILE	Определяет, установлен ли профиль в системе.
ICM_SETDEFAULTPROFILE	Делает профиль первым среди равных.
ICM_REGISTERICMATCHER	Регистрирует CMM в системе. Параметр pszFileName указывает на полный путь для библиотеки DLL CMM. Параметр lpszCMID указывает на DWORD идентификации CMM.
ICM_UNREGISTERICMATCHER	Отменяет регистрацию CMM из системы. Параметр lpszCMID указывает на DWORD идентификации CMM.
ICM_QUERYMATCH	Определяет, существует ли профиль на основе структуры DEVMODE , на которую указывает параметр pszFileName.

Возвращаемое значение

Если эта функция выполнена успешно, возвращаемое значение TRUE.

Если эта функция завершается ошибкой, возвращаемое значение FALSE.

Замечания

Не все параметры используются всеми функциями. Параметр nCommand указывает функцию для выполнения.

Эта функция сохраняется для обратной совместимости и может быть удалена в будущих версиях ICM.

Windows 95/98/Me: UpdateICMRegKeyW поддерживается Microsoft Layer для Юникода. Для этого необходимо добавить в приложение определенные файлы, как описано в Microsoft Layer для Юникода в Windows 95/98/Me Systems.

Заметка

Заголовок wingdi.h определяет UpdateICMRegKey как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

основные понятия управления цветами
Устаревшие функции WCS

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