Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

Locating the ColorSyncTM Profiles Folder /

CMGetColorSyncFolderSpec

Obtains the hierarchical file system (HFS) reference number and the directory ID for the ColorSync(TM) Profiles folder.

pascal CMError CMGetColorSyncFolderSpec (
short vRefNum, 
Boolean createFolder,
short *foundVRefNum,
long *foundDirID);

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 Boolean value you set to true to direct the ColorSync Manager to create the ColorSyncTM Profiles folder, if it does not exist. You can use the constants kCreateFolder and kDontCreateFolder, defined in the Folders.h file, to assign a value to the flag.

foundVRefNum

A pointer to a volume reference number. On output, the HFS volume reference number.

foundDirID

A pointer to a directory ID. On output, the HFS directory ID.

function result

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

DISCUSSION

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

SEE ALSO

For information about the Macintosh file system, see Inside Macintosh: Files.