SetColorProfileHeader function (icm.h)

Sets the header data in a specified ICC color profile.


BOOL SetColorProfileHeader(
  HPROFILE       hProfile,



Specifies a handle to the ICC color profile in question.


Pointer to the profile header data to write to the specified profile.

Return value

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.


This function will fail if hProfile is not a valid ICC profile.

If the color profile was not opened with read/write permission, SetColorProfileHeader fails.

SetColorProfileHeader overwrites the current header in the ICC profile.

This function does not support Windows Color System (WCS) profiles CAMP, DMP, and GMMP; because profile elements are implicitly associated with and hard coded to ICC tag types and there exist many robust XML parsing libraries.


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

See also