![]() |
CMUpdateProfileSearch |
||||
Header: | CMApplication.h | Carbon status: | Supported | |
Searches the ColorSync Profiles folder and updates an existing search result obtained originally from the CMNewProfileSearch function.
CMError CMUpdateProfileSearch ( CMProfileSearchRef search, void *refCon, UInt32 *count );
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 CMProfileSearchRef.
A pointer to 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 function CMProfileFilterProcPtr.
A pointer to a profile count. On return, 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.
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 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 functions 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 Profiles folder to occur at any time.
For a description of the function you call to begin a new search, see the function CMNewProfileSearch. That function specifies the filter function referred to in the description of the refCon parameter.
Starting with version 2.5, you should use the function CMIterateColorSyncFolder for profile searching.
This function is not recommended for use in ColorSync 2.5.
Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 2.0 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)