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

Функция 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

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