Функция AssociateColorProfileWithDeviceW (icm.h)
Связывает указанный цветовой профиль с указанным устройством.
Примечание
Этот API не поддерживает "расширенные цветовые" профили для мониторов HDR. Используйте ColorProfileAddDisplayAssociation для управления расширенными цветными профилями.
Синтаксис
BOOL AssociateColorProfileWithDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Параметры
pMachineName
Зарезервировано. Должно иметь значение NULL. Этот параметр предназначен для указания имени компьютера, с которым необходимо связать указанный профиль и устройство. Указатель NULL указывает на локальный компьютер.
pProfileName
Указывает на имя файла профиля, который необходимо связать.
pDeviceName
Указывает на имя устройства, которое необходимо связать.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.
Комментарии
Функция AssociateColorProfileWithDevice завершится ошибкой, если профиль не был установлен на компьютере с помощью функции InstallColorProfileW .
Обратите внимание, что в Windows (Windows 95 или более поздней версии) драйвер устройства PostScript для принтеров предполагает цветовую модель CMYK. Поэтому все принтеры PostScript должны использовать цветовой профиль CMYK. Windows 2000 не имеет этого ограничения.
Если указанное устройство является монитором, эта функция обновляет профиль по умолчанию.
Несколько профилей обычно связаны с принтерами на основе типов бумаги и рукописного ввода. Значение по умолчанию отсутствует. GDI выбирает лучший из связанных профилей, когда приложение создает контекст устройства (DC).
Сканеры также не имеют профиля по умолчанию. Однако нетипично связывать несколько профилей со сканером.
AssociateColorProfileWithDevice всегда добавляет указанный профиль в список сопоставлений профилей текущего пользователя для указанного устройства. Перед добавлением профиля в список AssociateColorProfileWithDevice определяет, выразил ли пользователь ранее желание использовать список сопоставлений профилей для каждого пользователя для устройства. Если да, то AssociateColorProfileWithDevice просто добавляет указанный профиль в существующий список сопоставлений профилей для каждого пользователя для устройства. В противном случае AssociateColorProfileWithDevice создает новый список сопоставлений профилей для каждого пользователя для устройства, скопировав список сопоставлений на уровне системы для этого устройства. Затем он добавляет указанный профиль в список для отдельных пользователей. С этого момента текущий пользователь будет использовать список сопоставлений профилей каждого пользователя для указанного устройства, как если бы wcsSetUsePerUserProfiles был вызван для pDevice с параметром usePerUserProfiles, для параметра usePerUserProfiles было задано значение TRUE.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |