GetColorProfileHeader function (icm.h)
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.
Syntax
BOOL 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 value
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
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | icm.h |
Library | Mscms.lib |
DLL | Mscms.dll |