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

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

  • Статья

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

Примечание

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

Синтаксис

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Параметры

scope

Значение WCS_PROFILE_MANAGEMENT_SCOPE, указывающее область этой операции управления профилями.

pEnumRecord

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

pBuffer

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

dwSize

Переменная, содержащая размер (в байтах) буфера, на который указывает pBuffer. См. Примечания.

pnProfiles

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

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

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

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

Комментарии

Используйте функцию WcsEnumColorProfilesSize , чтобы получить значение параметра dwSize , представляющее размер буфера в байтах, на который указывает параметр pBuffer .

Если параметр profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, учитываются только связи профилей на уровне системы с устройством. Если profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, учитываются только связи для текущего пользователя. Если wcsSetUsePerUserProfiles никогда не вызывался для этого пользователя или если wcsSetUsePerUserProfiles был недавно вызван для этого пользователя с параметром usePerUserProfiles , для которого задано значение FALSE, то WCSEnumColorProfiles возвращает пустой список.

Если присутствует WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (текущий пользовательский параметр), он переопределяет значение по умолчанию для всей системы для параметра profileManagementScope .

Эта функция является исполняемой в контексте Least-Privileged учетной записи пользователя (LUA).

Требования

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

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