Функция WcsAssociateColorProfileWithDevice (icm.h)
Связывает указанный цветовой профиль WCS с указанным устройством.
Примечание
Этот API не поддерживает "расширенные цветовые" профили для мониторов HDR. Используйте ColorProfileAddDisplayAssociation для управления расширенными цветными профилями.
Синтаксис
BOOL WcsAssociateColorProfileWithDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Параметры
scope
Значение WCS_PROFILE_MANAGEMENT_SCOPE, указывающее область данной операции управления профилем, которая может быть для всей системы или для текущего пользователя.
pProfileName
Указатель на имя файла профиля, который требуется связать.
pDeviceName
Указатель на имя устройства, с которым должен быть связан профиль.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.
Комментарии
Функция WCSAssociateColorProfileWithDevice завершается сбоем, если профиль не был установлен на компьютере с помощью функции InstallColorProfileW .
Если параметр profileManagementScope имеет значение WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, сопоставление профилей является общесистемным и применяется ко всем пользователям. Если параметр profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, связь будет связана только с текущим пользователем.
Эта функция выполняется в контексте Least-Privileged учетной записи пользователя (LUA), если параметр profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. В противном случае требуются права администратора.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |