Функция GetColorProfileFromHandle

Получив дескриптор открытого профиля цвета, функция GetColorProfileFromHandle скопирует содержание профиля в буфер, поставляемый приложением.

Синтаксис

Параметры

hProfile

Дескриптор открытого профиля цвета.

pBuffer

Указатель на буфер, который получает предварительные данные профиля. Он может быть НУЛЬ (NULL). Если это так, то размер, требуемый для буфера, сохранится в адресе ячейки памяти, указанной при помощи параметра pcbSize. Буфер может быть назначен соответствующего размера, а эта функция, вызывается снова с параметром pBuffer, содержащим адрес буфера.

pcbSize

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

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

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE). Она также возвращает значение ИСТИНА (TRUE), если параметр pBuffer - НУЛЬ (NULL), а размер, требуемый для буфера, копируется в pcbSize.

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

Смотри также

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