Contents

CMGetProfileLocation

Obtains the location of a profile based on the specified profile reference.

Declaration

CMError CMGetProfileLocation (
   CMProfileRef prof,
   CMProfileLocation *location
);

Parameters

  • prof:

    A profile reference of type Cmprofileref. Before calling CMGetProfileLocation, you set the reference to specify the profile you wish to obtain the location for.

  • theProfile:

    A pointer to a profile location structure of type Cmprofilelocation. On return, specifies the location of the profile. Commonly, a profile is disk-file based, but it may instead be temporary, handle-based, pointer-based, or accessed through a procedure supplied by your application.

Return Value

A CMError value. See Result Codes.

Overview

When your application calls the CMValidateProfile function, the ColorSync Manager dispatches the function to the CMM specified by the CMMType header field of the profile whose reference you specify. The preferred CMM can support this function or not.

To open a profile and obtain a reference to it, use the function CMOpenProfile.

Version-Notes

This function is not recommended for use in ColorSync 2.5.

Starting with ColorSync version 2.5, you should use the function NCMGetProfileLocation instead of CMGetProfileLocation.

As of version 2.5, if you call CMGetProfileLocation, it will just call NCMGetProfileLocation in turn, passing the profile specified by prof, the profile location specified by theProfile, and a location size value of cmOriginalProfileLocationSize.

See Also

Accessing Profiles