![]() |
CMGetColorSyncFolderSpec |
||||
Header: | CMApplication.h | Carbon status: | Supported | |
Obtains the volume reference number and the directory ID for the ColorSync Profiles folder.
CMError CMGetColorSyncFolderSpec ( SInt16 vRefNum, Boolean createFolder, SInt16 *foundVRefNum, SInt32 *foundDirID );
The reference number of the volume to examine. The volume must be mounted. The constant kOnSystemDisk defined in the Folders header file (Folders.h) specifies the active system volume.
A flag you set to true to direct the ColorSync Manager to create the ColorSync Profiles folder, if it does not exist. You can use the constants kCreateFolder and kDontCreateFolder, defined in the Folders.h header file, to assign a value to the flag.
A pointer to a volume reference number. On return, the volume reference number for the volume on which the ColorSync Profiles folder resides.
A pointer to a directory ID. On return, the directory ID for the volume on which the ColorSync Profiles folder resides.
If the ColorSync Profiles folder does not already exist, you can use this function to create it.
Starting with version 2.5, the name and location of the profile folder changed.
Your application should use the function CMIterateColorSyncFolder, available starting in ColorSync version 2.5, or one of the search functions described in Searching for Profiles Prior to ColorSync 2.5, to search for a profile file, even if it is only looking for one file. Do not search for a profile file by obtaining the location of the profiles folder and searching for the file directly.
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)