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

Перечисляет все профили, удовлетворяющие заданным критериям перечисления.

Синтаксис

BOOL EnumColorProfilesW(
  PCWSTR     pMachineName,
  PENUMTYPEW pEnumRecord,
  PBYTE      pEnumerationBuffer,
  PDWORD     pdwSizeOfEnumerationBuffer,
  PDWORD     pnProfiles
);

Параметры

pMachineName

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

pEnumRecord

Указатель на структуру, указывающую критерии перечисления.

pEnumerationBuffer

Указатель на буфер, в котором необходимо перечислить профили. Строка MULTI_SZ имен профилей, удовлетворяющих условиям, указанным в *pEnumRecord , будет помещена в этот буфер.

pdwSizeOfEnumerationBuffer

Указатель на переменную, содержащую размер буфера, на который указывает pBuffer. При возврате *pdwSize содержит размер буфера, который фактически использовался или необходим.

pnProfiles

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

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

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

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

Замечания

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

Не пытайтесь использовать EnumColorProfiles для определения профиля по умолчанию для устройства. Вместо этого создайте контекст устройства для устройства, а затем вызовите функцию GetICMProfile . В Windows Vista и Windows 7 функция WcsGetDefaultColorProfile также может использоваться для определения профиля цвета устройства по умолчанию.

Если элемент dwFields структуры типа ENUMTYPE , на который указывает параметр pEnumRecord , имеет значение ET_DEVICENAME, эта функция перечисляет все цветовые профили, связанные со всеми типами устройств, подключенных к компьютеру пользователя, независимо от класса устройства. Если элемент dwFields структуры, на который указывает параметр pEnumRecord , имеет значение ET_DEVICENAME или ET_DEVICECLASS, а класс устройства указан в элементе dwDeviceClass структуры, эта функция будет перечислять только профили, связанные с указанным классом устройства. Если для элемента dwFields задано только значение ET_DEVICECLASS, функция EnumColorProfiles перечисляет все профили, которые могут быть связаны с этим типом устройства.

Каждый раз, когда EnumColorProfiles проверяет профили, связанные с определенным устройством, результаты зависят от того, выбрал ли пользователь использовать список профилей, связанных с этим устройством, или его или его собственный ("на пользователя") список. Вызов WcsSetUsePerUserProfiles с параметром UsePerUserProfiles , равным TRUE , приводит к тому, что будущие вызовы EnumColorProfiles будут просматривать только список сопоставлений профилей текущего пользователя для указанного устройства. Вызов WcsSetUsePerUserProfiles с параметром UsePerUserProfiles , установленным значение FALSE , приводит к тому, что будущие вызовы EnumColorProfiles будут рассматривать список связей профилей для указанного устройства на уровне системы. Если wcsSetUsePerUserProfiles никогда не вызывался для текущего пользователя, EnumColorProfiles проверяет список на уровне системы.

Приложение может использовать EnumColorProfiles для получения размера буфера, в котором перечисляются профили. Он должен вызывать функцию EnumColorProfiles с параметром pBuffer , установленным значение NULL. Когда функция возвращается, параметр pdwSize будет содержать требуемый размер буфера в байтах. Программа может использовать эти сведения для выделения буфера перечисления. Затем он может снова вызвать EnumColorProfiles с параметром pBuffer , заданным для адреса буфера.

Эта функция предоставит сведения о преобразовании данных DMP для WCS в устаревшую запись EnumType в включении согласованного перечисления профилей. Значения по умолчанию будут совпадать с параметром ICC, если эта информация отсутствует.

Поддержка для каждого пользователя или LUA

Перечисление зависит от текущего пользователя. Рассматриваются связи устройств с широкими системами и текущими пользователями. Для конфигурации профиля по умолчанию текущие параметры пользователя переопределяют широкие системные параметры.

Требования

См. также

• Основные понятия управления цветами
• Функции
• GetICMProfile
• ENUMTYPEW