Функция OpenColorProfile

Функция OpenColorProfile создает дескриптор указанного профиля цвета. Дескриптор может затем использоваться в других функциях управления профилем.

Синтаксис

HPROFILE WINAPI OpenColorProfile(
  PPROFILE pProfile,
  DWORD dwDesiredAccess,
  DWORD dwShareMode,
  DWORD dwCreationMode
);

Параметры

pProfile

Указатель на структуру профиля цвета, определяющую профиль. Указатель pProfile может быть освобожден, как только дескриптор будет создан.

dwDesiredAccess

Определяет, как получить доступ к данному профилю. Этот параметр должен получить одно из нижеследующих постоянных значений.

Константа Предназначение
PROFILE_READ Открывает доступ к профилю для чтения.
PROFILE_READWRITE Открывает доступ к профилю и для чтения, и для записи.

dwShareMode

Определяет, как профиль должен совместно использоваться, если профиль содержится в файле. Значение нуля препятствует профилю совместно использоваться вообще. Параметр может содержать одну или обе из нижеследующих констант (объединенных добавлением или логическим ИЛИ (OR)).

Константа Предназначение
FILE_SHARE_READ Другие операции открытия могут выполниться на профиле для доступа к чтению.
FILE_SHARE_WRITE Другие операции открытия могут выполниться на профиле для доступа к записи.

dwCreationMode

Определяет, какие действия применяются к профилю, когда он открывается, если он содержится в файле. Этот параметр должен получить одну из нижеследующих постоянных значений.

Константа Предназначение
CREATE_NEW Создает новый профиль. Завершается ошибкой, если профиль уже существует.
CREATE_ALWAYS Создает новый профиль. Переписывает профиль, если он существует.
OPEN_EXISTING Открывает профиль. Завершается ошибкой, если он не существует
OPEN_ALWAYS Открывает профиль, если он существует. Если он не существует, создает профиль.
TRUNCATE_EXISTING Открывает профиль, и усекает его до нуля байтов. Завершается ошибкой, если профиль не существует.

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

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

Если эта функция завершается ошибкой, возвращаемое значение - НУЛЬ (NULL). Для дополнительной информации об ошибке, вызовите GetLastError.

Замечания

Если данные профиля не определены, используется имя файла dwShareMode, а dwCreationMode игнорируется.

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

Используйте функцию CloseColorProfile, чтобы закрыть дескриптор объекта, возвращенный OpenColorProfile.

Смотри также

Обзор Основные понятия управления цветом, Функции, используемые ICM, CloseColorProfile, PROFILE

Размещение и совместимость OpenColorProfile

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Нет
е Windows Me Да
н Windows 98 Да
т Windows 95 Нет
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Нет
в    
е    
р    
Используемая библиотека Mscms.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Icm.h
 - включено в -
 Unicode Реализуется как версии Unicode и ANSI в Windows 2000/XP.
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz