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

CMSearchGetIndProfileFileSpec

Obtains the file specification for the profile at a specific index into a search result.

pascal CMError CMSearchGetIndProfileFileSpec (
CMProfileSearchRef search,
unsigned long index,
FSSpec *profileFile);

search

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

index

The index of the profile whose file specification you want to obtain. This is a one-based index into a set of profiles in the search result list. This 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.

profileFile

A pointer to a file specification. On output, this parameter points to a file specification for the profile at the location specified by index. For a description of the FSSpec data type, see Inside Macintosh: Files.

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 CMSearchGetIndProfileFileSpec 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 ColorSync.

The CMSearchGetIndProfileFileSpec function obtains the Macintosh file system file specification for a profile at a specific index in the search result list.