Функция GetStandardColorSpaceProfileW (icm.h)
Извлекает профиль цвета, зарегистрированный для указанного стандартного цветового пространства.
Синтаксис
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
Параметры
pMachineName
Зарезервировано. Должен иметь значение NULL. Этот параметр предназначен для указания на имя компьютера, на котором требуется получить стандартный профиль цветового пространства. Указатель NULL указывает на локальный компьютер.
dwSCS
Задает значение идентификатора стандартного цветового пространства, для которого требуется получить профиль. Единственными допустимыми значениями для этого параметра являются LCS_sRGB и LCS_WINDOWS_COLOR_SPACE.
pBuffer
Указатель на буфер, в котором должно быть размещено имя профиля. Если значение РАВНО NULL, вызов возвращает значение TRUE , а требуемый размер буфера помещается в pdwSize.
pcbSize
Указатель на переменную, содержащую размер буфера в байтах, на который указывает pProfileName. При возврате переменная содержит размер буфера, который фактически используется или требуется.
Возвращаемое значение
Если эта функция выполняется успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Если буфер, на который указывает pProfileName , должен динамически выделяться приложением, приложение может вызвать функцию GetStandardColorSpaceProfile , чтобы получить размер, необходимый для буфера. Если метод GetStandardColorSpaceProfile вызывается с параметром pProfileName , равным NULL, он возвращает значение FALSE , а DWORD , на который указывает pdwSize , будет содержать количество байтов, необходимых для буфера, на который указывает pProfileName. Затем приложение может выделить буфер и снова вызвать GetStandardColorSpaceProfile с параметром pProfileName , равным адресу буфера.
Эта функция поддерживает профили модели устройств (DMP) Windows Color System (WCS) в дополнение к профилям Международного консорциума цветов (ICC). Он не поддерживает профили WCS CAMP или GMMP и возвращает ошибку, если такие профили используются.
Общие сведения о конкретных функциональных возможностях Windows Vista
Это будет поддерживать dmp WCS в дополнение к профилям ICC. Он не будет поддерживать профили WCS CAMP или GMMP и возвращает ошибку, если такие профили используются с этим API.
Поддержка для отдельных пользователей и LUA
При этом будет получен цветной профиль, зарегистрированный для заданного стандартного цветового пространства для текущего пользователя. Если этот параметр отсутствует для текущего пользователя, он извлекает параметр на уровне системы.
Для этого используется wcsGetDefaultColorProfile с WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Это исполняемый файл в контексте LUA.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |