SetColorProfileElementReference function

SetColorProfileElementReference creates in a specified ICC color profile a new tag which references the same data as an existing tag.

Syntax


BOOL WINAPI SetColorProfileElementReference(
   HPROFILE hProfile,
   TAGTYPE  newTag,
   TAGTYPE  refTag
);

Parameters

hProfile

Specifies a handle to the ICC color profile in question.

newTag

Identifies the new tag to create.

refTag

Identifies the existing tag whose data is to be referenced by the new tag.

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.

Remarks

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

If newTag already exists or refTag does not exist, SetColorProfileElementReference fails.

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

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.

Requirements

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

Basic Color Management Concepts
Functions

 

 

Show: