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