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 );
Specifies a handle to the color profile in question.
Points to a variable in which the ICC header structure is to be placed.
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.
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').
Minimum supported client
|Windows 2000 Professional|
Minimum supported server
|Windows 2000 Server|
Build date: 11/16/2010