Carbon


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
);
Parameter descriptions
vRefNum

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.

createFolder

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.

foundVRefNum

A pointer to a volume reference number. On return, the volume reference number for the volume on which the ColorSync Profiles folder resides.

foundDirID

A pointer to a directory ID. On return, the directory ID for the volume on which the ColorSync Profiles folder resides.

DISCUSSION

If the ColorSync Profiles folder does not already exist, you can use this function to create it.

VERSION NOTES

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.

AVAILABILITY

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)