Поделиться через

Функция DisassociateColorProfileFromDeviceW (icm.h)

  • Статья

Отменяет связь указанного цветового профиля с указанным устройством на указанном компьютере.

Примечание

Этот API не поддерживает "расширенные цветовые" профили для мониторов HDR. Используйте ColorProfileRemoveDisplayAssociation для управления расширенными цветными профилями.

Синтаксис

BOOL DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

Параметры

pMachineName

Зарезервировано. Должно иметь значение NULL. Этот параметр предназначен для указания имени компьютера, на котором необходимо отменить связь с указанным профилем и устройством. Указатель NULL указывает на локальный компьютер.

pProfileName

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

pDeviceName

Указатель на имя устройства для отмены связи.

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

Если эта функция завершается успешно, возвращается значение TRUE.

Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Комментарии

Если с устройством связано несколько профилей, WCS использует последний из них в качестве профиля по умолчанию. То есть, если приложение последовательно связывает три профиля с устройством, WCS будет использовать последний связанный в качестве профиля по умолчанию. Если приложение вызывает функцию DisassociateColorProfileFromDevice для отмены связи с третьим профилем (который в этом примере используется по умолчанию), WCS будет использовать второй профиль в качестве профиля по умолчанию.

Если приложение отменяет связь всех профилей с устройством, WCS использует профиль sRGB в качестве профиля по умолчанию.

DisassociateColorProfileFromDevice всегда удаляет указанный профиль из списка сопоставлений профилей текущего пользователя для указанного устройства. Перед удалением профиля из списка disassociateColorProfileFromDevice определяет, выразил ли пользователь ранее желание использовать список сопоставлений профилей для каждого пользователя для устройства. Если да, то disassociateColorProfileFromDevice просто удаляет указанный профиль из существующего списка сопоставлений профилей пользователя для устройства. В противном случае DisassociateColorProfileFromDevice создает новый список сопоставлений профилей для каждого пользователя для устройства, скопировав список сопоставлений для всей системы для этого устройства. Затем указанный профиль удаляется из списка для отдельных пользователей. С этого момента текущий пользователь будет использовать список сопоставлений профилей каждого пользователя для указанного устройства, как если бы wcsSetUsePerUserProfiles был вызван для pDevice с параметром usePerUserProfiles, для параметра usePerUserProfiles было задано значение TRUE.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

См. также раздел