Функция 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. | |
| Замечания по платформе | Не имеется | |