Функция AssociateColorProfileWithDevice

Функция AssociateColorProfileWithDevice связывает заданный цветной профиль с заданным устройством.

Синтаксис

BOOL WINAPI AssociateColorProfileWithDevice(
  PCTSTR pMachineName,  // зарезервирован, должен быть НУЛЬ (NULL)
  PCTSTR pProfileName,  // имя файла, содержащее профиль устройства
  PCTSTR pDeviceName    // название устройства
);

Параметры

pMachineName

Зарезервирован; должен быть НУЛЬ (NULL). Этот параметр предназначается, чтобы указывать название компьютера, на котором связывается заданный профиль и устройство. Пустой указатель указывает локальный компьютер.

pProfileName

Указывает на имя файла, связанного с профилем.

pDeviceName

Указывает на имя файла, связанного с устройством.

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

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE).

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Для дополнительной информации об ошибке, вызовите GetLastError.

Замечания

Вообще, профиль по умолчанию - последний профиль, связанный с устройством. Таким образом, если ваше приложение последовательно связывает два профиля с устройством, второй профиль должен быть значением по умолчанию.

Функция AssociateColorProfileWithDevice завершится ошибкой, если профиль не был установлен на компьютере, при помощи использования функции InstallColorProfile.

Обратите внимание! на то, что это в среде Windows (Windows 95 или позже), PostScript драйвер устройства для принтеров принимает цветовую модель CMYK. Поэтому, все PostScript принтеры должны использовать профиль цвета CMYK. Windows 2000 не имеет этого ограничения.

Если заданное устройство - монитор, эта функция обновляет профиль по умолчанию.

Несколько профилей с принтерами связываются стандартно, основываясь на типах бумаги и чернил. Значений по умолчанию нет. Интерфейс графического устройства (GDI) выбирает один из лучших среди связанных профилей, когда ваше приложение создает контекст устройства (DC).

Сканеры также не имеют профиля по умолчанию. Однако, больше чем один профиль со сканером связывается нестандартно.

Смотри также

Обзор Основные концепции управления цветом, Функции, используемые ICM, DisassociateColorProfileFromDevice

Размещение и совместимость AssociateColorProfileWithDevice
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Нет
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Нет
в
е
р
Используемая библиотека		Mscms.lib
Используемая DLL		-
Заголовочный файл
- объявлено в		Icm.h
- включено в		-
Unicode		В Windows 2000/XP Осуществляются как версии Unicode и ANSI.
Замечания по платформе		Не имеется