SetColorProfileElementReference

[This is preliminary documentation and subject to change.]

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

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

Parameters

hProfile
Specifies a handle to the 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 Values

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

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

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

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.

See Also

Color Management Overview, ICM 2.0 Functions