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

CMUpdateProfileSearch

Searches the ColorSyncTM Profiles folder and updates an existing search result obtained originally from the CMNewProfileSearch function.

pascal CMError CMUpdateProfileSearch (
CMProfileSearchRef search,
void *refCon,
unsigned long *count);

search

A reference to a search result list returned to your application when you called the CMNewProfileSearch function. For a description of the CMProfileSearchRef private data type, see "Profile Search Result Reference" (page 3-63).

refCon

A reference constant for application data passed as a parameter to calls to the filter function specified by the original search specification. For a description of the filter function, see the MyCMProfileFilterProc function (page 3-171).

count

A pointer to a profile count. On output, if the function result is noErr, a one-based count of the number of profiles matching the original search specification passed to the CMNewProfileSearch function. Otherwise undefined.

function result

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

DISCUSSION

After a profile search has been set up and performed through a call to the CMNewProfileSearch function, the CMUpdateProfileSearch function updates the existing search result. You must use this function if the contents of the ColorSync(TM) Profiles folder have changed since the original search result was created.

The search update uses the original search specification, including the filter function indicated by the search record. Data given in the CMUpdateProfileSearch function's refCon parameter is passed to the filter function each time it is called.

Sharing a disk over a network makes it possible for modification of the contents of the ColorSync(TM) Profiles folder to occur at any time.

SEE ALSO

For a description of the function you call to begin a new search, see the CMNewProfileSearch function (page 3-133). This function specifies the filter function referred to in the description of the refCon parameter.