Функция GetColorDirectoryA (icm.h)
Примечание
Этот API может быть недоступен в будущих выпусках. Мы рекомендуем новому и существующему программному обеспечению использовать другие API для взаимодействия с цветовым профилем. Некоторые примеры см. в таблице ниже.
| Сценарий | Механизм |
|---|---|
| Перечисление всех установленных профилей | Использование WcsEnumColorProfilesSize и WcsEnumColorProfiles или EnumColorProfilesA |
| Установка и удаление цветовых профилей | Использование InstallColorProfileA/UninstallColorProfileA |
| Открытие файла цветового профиля напрямую | Используйте OpenColorProfileA с dwType=PROFILE_FILENAME в параметре структуры PROFILE. Или используйте WcsOpenColorProfileA. Icm.h содержит множество API- интерфейсов, которые принимают возвращенный HPROFILE для обработки профиля цвета. |
Извлекает путь к каталогу Windows COLOR на указанном компьютере.
Синтаксис
BOOL GetColorDirectoryA(
PCSTR pMachineName,
PSTR pBuffer,
PDWORD pdwSize
);
Параметры
pMachineName
Защищены; значение должно иметь значение NULL. Этот параметр указывает на имя компьютера, на котором будет установлен профиль. Указатель NULL указывает на локальный компьютер.
pBuffer
Указывает на буфер, в котором должен быть размещен путь к цветовому каталогу.
pdwSize
Указывает на переменную, содержащую размер буфера в байтах, на который указывает pBuffer. При возврате переменная содержит размер буфера, который фактически используется или требуется.
Возвращаемое значение
Если эта функция выполняется успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.
Комментарии
Поддержка для отдельных пользователей и LUA
Каталог color по-прежнему является системным. Эта функция является исполняемой в контексте LUA.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |