(Устаревшая; сохранена для обратной совместимости)
Функция UpdateICMRegKey управляет профилями цвета и Модулями управления цветом (CMM) в системе.
Синтаксис
BOOL UpdateICMRegKey( DWORD dwReserved, LPTSTR lpszCMID, LPTSTR lpszFileName, UINT nCommand ); |
dwReserved
Зарезервированный, должен быть установлен в нуль.
lpszCMID
Указывает на строку, которая определяет идентификатор профиля ICC для динамически подключаемой библиотеки (DLL) управления цветом, которая используется с профилем.
lpszFileName
Указывает на полное квалифицированное имя файла профиля цвета ICC или на структуру DEVMODE.
nCommand
Определяет выполняемое действие. Это может быть одно из нижеследующих значений.
| Значение | Предназначение |
|---|---|
| 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 for Unicode. Чтобы использовать этот модуль, Вы должны добавить определенные файлы к вашему приложению, как это подчеркнуто в Microsoft Layer for Unicode для систем Windows 95/98/Me.
Обзор Основные понятия управления цветом, Функции, используемые ICM
|
Размещение и совместимость UpdateICMRegKey |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 4.0 и выше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Нет |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | - | |
| Unicode | Реализуется как версии Unicode и ANSI для Windows 2000/XP. Также поддерживает Microsoft Layer for Unicode. | |
| Замечания по платформе | Не имеется | |