Функция GetColorDirectoryW (icm.h)
Примечание
Этот API может быть недоступен в будущих выпусках. Мы рекомендуем новому и существующему программному обеспечению использовать другие API для взаимодействия с цветными профилями. Некоторые примеры см. в таблице ниже.
| Сценарий | Механизм |
|---|---|
| Перечисление всех установленных профилей | Использование WcsEnumColorProfilesSize и WcsEnumColorProfiles или EnumColorProfilesW |
| Установка и удаление цветовых профилей | Использование InstallColorProfileW/UninstallColorProfileW |
| Открытие файла цветового профиля напрямую | Используйте OpenColorProfileW с dwType=PROFILE_FILENAME в параметре структуры PROFILE. Или используйте WcsOpenColorProfileW. Icm.h содержит множество API- интерфейсов, которые принимают возвращенный HPROFILE для обработки цветового профиля. |
Извлекает путь к каталогу Windows COLOR на указанном компьютере.
Синтаксис
BOOL GetColorDirectoryW(
PCWSTR pMachineName,
PWSTR 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 |