Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

Profile Searching / Searching External Profiles

CMSearchGetIndProfile

Opens the profile corresponding to a specific index into a specific search result list and obtains a reference to that profile.

pascal CMError CMSearchGetIndProfile (
CMProfileSearchRef search,
unsigned long index,
CMProfileRef *prof);

search

A reference to the profile search result list containing the profile whose reference you want to obtain. For a description of the CMProfileSearchRef private data type, see "Profile Search Result Reference" (page 3-63).

index

The position of the profile in the search result list. This value is specified as a one-based index into the set of profiles of the search result. The number must be within the range returned as the count parameter of the CMNewProfileSearch function or the CMUpdateProfileSearch function if the search result was updated.

prof

A pointer to a profile reference (page 3-63). On output, the reference refers to the profile associated with the specified index.

function result

A result code of type CMError. See "Result Codes" (page 3-174) for a list of ColorSync-specific result codes.

DISCUSSION

Before your application can call the CMSearchGetIndProfile function, it must call the CMNewProfileSearch function (page 3-133) to perform a profile search and produce a search result list. The search result list is a private data structure maintained by the ColorSync Manager. After your application has finished using the profile reference, it must close the reference by calling the CMCloseProfile function (page 3-71).