CMSetProfileElementReference
Adds a tag to the specified profile to refer to data corresponding to a previously set element.
Declaration
CMError CMSetProfileElementReference (
CMProfileRef prof,
OSType elementTag,
OSType referenceTag
);Parameters
- prof:
A profile reference of type Cmprofileref to the profile to add the tag to.
- elementTag:
The original element’s signature tag corresponding to the element data to which the new tag will refer.
- referenceTag:
The new tag signature to add to the profile to refer to the element data corresponding to
elementTag.
Return Value
A CMError value. See Result Codes.
Overview
After the CMSetProfileElementReference function executes successfully, the specified profile will contain more than one tag corresponding to a single piece of data. All of these tags are of equal importance. Your application can set a reference to an element that was originally a reference itself without circularity.
If you call the function CMSetProfileElement subsequently for one of the tags acting as a reference to another tag’s data, then the element data you provide is set for the tag and the tag is no longer considered a reference. Instead, the tag corresponds to its own element data and not that of another tag.