GetColorProfileHeader
The GetColorProfileHeader function retrieves or derives ICC header structure from either ICC color profile or WCS XML profile. Drivers and applications should assume returning TRUE only indicates that a properly structured header is returned. Each tag will still need to be validated independently using either legacy ICM2 APIs or XML schema APIs.
BOOL WINAPI GetColorProfileHeader(
HPROFILE hProfile, PPROFILEHEADER pHeader);
Parameters
- hProfile
Specifies a handle to the color profile in question. - pHeader
Points to a variable in which the ICC header structure is to be placed.
Return Values
If this function succeeds, the return value is TRUE.
If this function fails, the return value is FALSE. This function will fail is an invalid ICC or WCS XML profile is referenced in the hProfile parameter. For extended error information, call GetLastError.
Remarks
To determine whether the header is derived from an ICC or DMP profile handle, check the header signature (header bytes 36-39 ). If the signature is "acsp" (big endian) then an ICC profile was used. If the signature is "cdmp" (big-endian) then a DMP was used.
The distinguishing features that identify a header as having been "synthesized" for a WCS DMP are:
pIcmProfileHeader->phSignature = 'pmdc' (little endian = big endian 'cdmp')
pIcmProfileHeader->phCMMType = '1scw' (little endian = big endian 'wcs1').
Requirements
** Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
** Windows 95/98/Me:** Included in Windows 98 and later.
** Header:** Declared in Icm.h.
** Library:** Use Mscms.lib.