enum {
      kExtensionDisabledFolderType = FOUR_CHAR_CODE('extD'),
      kControlPanelDisabledFolderType = FOUR_CHAR_CODE('ctrD'),
      kSystemExtensionDisabledFolderType = FOUR_CHAR_CODE('macD'),
      kStartupItemsDisabledFolderType = FOUR_CHAR_CODE('strD'),
      kShutdownItemsDisabledFolderType = FOUR_CHAR_CODE('shdD'),
      kApplicationsFolderType     = FOUR_CHAR_CODE('apps'),
      kDocumentsFolderType        = FOUR_CHAR_CODE('docs')
  };
  
  enum {
                                                                  /* new constants */
      kVolumeRootFolderType       = FOUR_CHAR_CODE('root'),       /* root folder of a volume */
      kChewableItemsFolderType    = FOUR_CHAR_CODE('flnt'),       /* items deleted at boot */
      kApplicationSupportFolderType = FOUR_CHAR_CODE('asup'),     /* third-party items and folders */
      kTextEncodingsFolderType    = FOUR_CHAR_CODE('Ätex'),       /* encoding tables */
      kStationeryFolderType       = FOUR_CHAR_CODE('odst'),       /* stationery */
      kOpenDocFolderType          = FOUR_CHAR_CODE('odod'),       /* OpenDoc root */
      kOpenDocShellPlugInsFolderType = FOUR_CHAR_CODE('odsp'),    /* OpenDoc Shell Plug-Ins in OpenDoc folder */
      kEditorsFolderType          = FOUR_CHAR_CODE('oded'),       /* OpenDoc editors in MacOS Folder */
      kOpenDocEditorsFolderType   = FOUR_CHAR_CODE('Äodf'),       /* OpenDoc subfolder of Editors folder */
      kOpenDocLibrariesFolderType = FOUR_CHAR_CODE('odlb'),       /* OpenDoc libraries folder */
      kGenEditorsFolderType       = FOUR_CHAR_CODE('Äedi'),       /* CKH general editors folder at root level of Sys folder */
      kHelpFolderType             = FOUR_CHAR_CODE('Ählp'),       /* CKH help folder currently at root of system folder */
      kInternetPlugInFolderType   = FOUR_CHAR_CODE('Änet'),       /* CKH internet plug ins for browsers and stuff */
      kModemScriptsFolderType     = FOUR_CHAR_CODE('Ämod'),       /* CKH modem scripts, get 'em OUT of the Extensions folder */
      kPrinterDescriptionFolderType = FOUR_CHAR_CODE('ppdf'),     /* CKH new folder at root of System folder for printer descs. */
      kPrinterDriverFolderType    = FOUR_CHAR_CODE('Äprd'),       /* CKH new folder at root of System folder for printer drivers */
      kScriptingAdditionsFolderType = FOUR_CHAR_CODE('Äscr'),     /* CKH at root of system folder */
      kSharedLibrariesFolderType  = FOUR_CHAR_CODE('Älib'),       /* CKH for general shared libs. */
      kVoicesFolderType           = FOUR_CHAR_CODE('fvoc'),       /* CKH macintalk can live here */
      kControlStripModulesFolderType = FOUR_CHAR_CODE('sdev'),    /* CKH for control strip modules */
      kAssistantsFolderType       = FOUR_CHAR_CODE('astÄ'),       /* SJF for Assistants (MacOS Setup Assistant, etc) */
      kUtilitiesFolderType        = FOUR_CHAR_CODE('utiÄ'),       /* SJF for Utilities folder */
      kAppleExtrasFolderType      = FOUR_CHAR_CODE('aexÄ'),       /* SJF for Apple Extras folder */
      kContextualMenuItemsFolderType = FOUR_CHAR_CODE('cmnu'),    /* SJF for Contextual Menu items */
      kMacOSReadMesFolderType     = FOUR_CHAR_CODE('morÄ'),       /* SJF for MacOS ReadMes folder */
      kALMModulesFolderType       = FOUR_CHAR_CODE('walk'),       /* EAS for Location Manager Module files except type 'thng' (within kExtensionFolderType) */
      kALMPreferencesFolderType   = FOUR_CHAR_CODE('trip'),       /* EAS for Location Manager Preferences (within kPreferencesFolderType; contains kALMLocationsFolderType) */
      kALMLocationsFolderType     = FOUR_CHAR_CODE('fall'),       /* EAS for Location Manager Locations (within kALMPreferencesFolderType) */
      kColorSyncProfilesFolderType = FOUR_CHAR_CODE('prof'),      /* for ColorSync(tm) Profiles */
      kThemesFolderType           = FOUR_CHAR_CODE('thme'),       /* for Theme data files */
      kFavoritesFolderType        = FOUR_CHAR_CODE('favs'),       /* Favorties folder for Navigation Services */
      kInternetFolderType         = FOUR_CHAR_CODE('intÄ'),       /* Internet folder (root level of startup volume) */
      kAppearanceFolderType       = FOUR_CHAR_CODE('appr'),       /* Appearance folder (root of system folder) */
      kSoundSetsFolderType        = FOUR_CHAR_CODE('snds'),       /* Sound Sets folder (in Appearance folder) */
      kDesktopPicturesFolderType  = FOUR_CHAR_CODE('dtpÄ'),       /* Desktop Pictures folder (in Appearance folder) */
      kInternetSearchSitesFolderType = FOUR_CHAR_CODE('issf'),    /* Internet Search Sites folder */
      kFindSupportFolderType      = FOUR_CHAR_CODE('fnds'),       /* Find support folder */
      kFindByContentFolderType    = FOUR_CHAR_CODE('fbcf'),       /* Find by content folder */
      kInstallerLogsFolderType    = FOUR_CHAR_CODE('ilgf'),       /* Installer Logs folder */
      kScriptsFolderType          = FOUR_CHAR_CODE('scrÄ'),       /* Scripts folder */
      kFolderActionsFolderType    = FOUR_CHAR_CODE('fasf'),       /* Folder Actions Scripts folder */
      kLauncherItemsFolderType    = FOUR_CHAR_CODE('laun'),       /* Launcher Items folder */
      kRecentApplicationsFolderType = FOUR_CHAR_CODE('rapp'),     /* Recent Applications folder */
      kRecentDocumentsFolderType  = FOUR_CHAR_CODE('rdoc'),       /* Recent Documents folder */
      kRecentServersFolderType    = FOUR_CHAR_CODE('rsvr'),       /* Recent Servers folder */
      kSpeakableItemsFolderType   = FOUR_CHAR_CODE('spki'),       /* Speakable Items folder */
      kKeychainFolderType         = FOUR_CHAR_CODE('kchn'),       /* Keychain folder */
      kQuickTimeExtensionsFolderType = FOUR_CHAR_CODE('qtex'),    /* QuickTime Extensions Folder (in Extensions folder) */
      kDisplayExtensionsFolderType = FOUR_CHAR_CODE('dspl'),      /* Display Extensions Folder (in Extensions folder) */
      kMultiprocessingFolderType  = FOUR_CHAR_CODE('mpxf'),       /* Multiprocessing Folder (in Extensions folder) */
      kPrintingPlugInsFolderType  = FOUR_CHAR_CODE('pplg')        /* Printing Plug-Ins Folder (in Extensions folder) */
  };
  
  enum {
      kLocalesFolderType          = FOUR_CHAR_CODE('Äloc'),       /* PKE for Locales folder */
      kFindByContentPluginsFolderType = FOUR_CHAR_CODE('fbcp')    /* Find By Content Plug-ins */
  };
  
  enum {
      kUsersFolderType            = FOUR_CHAR_CODE('usrs'),       /* "Users" folder, contains one folder for each user. */
      kCurrentUserFolderType      = FOUR_CHAR_CODE('cusr'),       /* The folder for the currently logged on user. */
      kCurrentUserRemoteFolderLocation = FOUR_CHAR_CODE('rusf'),  /* The remote folder for the currently logged on user */
      kCurrentUserRemoteFolderType = FOUR_CHAR_CODE('rusr'),      /* The remote folder location for the currently logged on user */
      kSharedUserDataFolderType   = FOUR_CHAR_CODE('sdat'),       /* A Shared "Documents" folder, readable & writeable by all users */
      kVolumeSettingsFolderType   = FOUR_CHAR_CODE('vsfd')        /* Volume specific user information goes here */
  };
  
  /* FolderDescFlags values */
  enum {
      kCreateFolderAtBoot         = 0x00000002,
      kFolderCreatedInvisible     = 0x00000004,
      kFolderCreatedNameLocked    = 0x00000008,
      kFolderCreatedAdminPrivs    = 0x00000010
  };
  
  enum {
      kFolderInUserFolder         = 0x00000020,
      kFolderTrackedByAlias       = 0x00000040,
      kFolderInRemoteUserFolderIfAvailable = 0x00000080,
      kFolderNeverMatchedInIdentifyFolder = 0x00000100,
      kFolderMustStayOnSameVolume = 0x00000200,
      kFolderInLocalOrRemoteUserFolder = kFolderInUserFolder | kFolderInRemoteUserFolderIfAvailable
  };
  
  typedef UInt32                          FolderDescFlags;
  /* FolderClass values */
  enum {
      kRelativeFolder             = FOUR_CHAR_CODE('relf'),
      kSpecialFolder              = FOUR_CHAR_CODE('spcf')
  };
  
  typedef OSType                          FolderClass;
  /* special folder locations */
  enum {
      kBlessedFolder              = FOUR_CHAR_CODE('blsf'),
      kRootFolder                 = FOUR_CHAR_CODE('rotf')
  };
  
  enum {
      kCurrentUserFolderLocation  = FOUR_CHAR_CODE('cusf')        /*    the magic 'Current User' folder location*/
  };
  
  typedef OSType                          FolderType;
  typedef OSType                          FolderLocation;
  
  struct FolderDesc {
      Size                            descSize;
      FolderType                      foldType;
      FolderDescFlags                 flags;
      FolderClass                     foldClass;
      FolderType                      foldLocation;
      OSType                          badgeSignature;
      OSType                          badgeType;
      UInt32                          reserved;
      StrFileName                     name;                       /* Str63 on MacOS*/
  };
  typedef struct FolderDesc               FolderDesc;
  typedef FolderDesc *                    FolderDescPtr;
  
  typedef UInt32                          RoutingFlags;
  
  struct FolderRouting {
      Size                            descSize;
      OSType                          fileType;
      FolderType                      routeFromFolder;
      FolderType                      routeToFolder;
      RoutingFlags                    flags;
  };
  typedef struct FolderRouting            FolderRouting;
  typedef FolderRouting *                 FolderRoutingPtr;
  /* routing constants */
  /*  These are bits in the .flags field of the FindFolderUserRedirectionGlobals struct*/
  enum {
                                                                  /*    Set this bit to 1 in the .flags field of a FindFolderUserRedirectionGlobals*/
                                                                  /*    structure if the userName in the struct should be used as the current*/
                                                                  /*    "User" name*/
      kFindFolderRedirectionFlagUseDistinctUserFoldersBit = 0,    /*    Set this bit to 1 and the currentUserFolderVRefNum and currentUserFolderDirID*/
                                                                  /*    fields of the user record will get used instead of finding the user folder*/
                                                                  /*    with the userName field.*/
      kFindFolderRedirectionFlagUseGivenVRefAndDirIDAsUserFolderBit = 1, /*    Set this bit to 1 and the remoteUserFolderVRefNum and remoteUserFolderDirID*/
                                                                  /*    fields of the user record will get used instead of finding the user folder*/
                                                                  /*    with the userName field.*/
      kFindFolderRedirectionFlagsUseGivenVRefNumAndDirIDAsRemoteUserFolderBit = 2
  };
  
  struct FindFolderUserRedirectionGlobals {
      UInt32                          version;
      UInt32                          flags;
  
      Str31                           userName;
      short                           userNameScript;
  
      short                           currentUserFolderVRefNum;
      long                            currentUserFolderDirID;
  
      short                           remoteUserFolderVRefNum;
      long                            remoteUserFolderDirID;
  };
  typedef struct FindFolderUserRedirectionGlobals FindFolderUserRedirectionGlobals;
  typedef FindFolderUserRedirectionGlobals * FindFolderUserRedirectionGlobalsPtr;
  enum {
      kFolderManagerUserRedirectionGlobalsCurrentVersion = 1
  };
  
  /*
      These are passed into FindFolderExtended(), FindFolderInternalExtended(), and
      FindFolderNewInstallerEntryExtended() in the flags field. 
  */
  enum {
      kFindFolderExtendedFlagsDoNotFollowAliasesBit = 0,
      kFindFolderExtendedFlagsDoNotUseUserFolderBit = 1,
      kFindFolderExtendedFlagsUseOtherUserRecord = 0x01000000
  };
  
  typedef CALLBACK_API( OSStatus , FolderManagerNotificationProcPtr )(OSType message, void *arg, void *userRefCon);
  typedef STACK_UPP_TYPE(FolderManagerNotificationProcPtr)        FolderManagerNotificationUPP;
  if OPAQUE_UPP_TYPES
      EXTERN_API(FolderManagerNotificationUPP)
      NewFolderManagerNotificationUPP    (FolderManagerNotificationProcPtr userRoutine);
  
      EXTERN_API(void)
      DisposeFolderManagerNotificationUPP    (FolderManagerNotificationUPP userUPP);
  
      EXTERN_API(OSStatus)
      InvokeFolderManagerNotificationUPP    (OSType           message,
                                      void *                  arg,
                                      void *                  userRefCon,
                                      FolderManagerNotificationUPP userUPP);
  
  else
      enum { uppFolderManagerNotificationProcInfo = 0x00000FF0 };     /* pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes) */
      #define NewFolderManagerNotificationUPP(userRoutine)            (FolderManagerNotificationUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppFolderManagerNotificationProcInfo, GetCurrentArchitecture())
      #define DisposeFolderManagerNotificationUPP(userUPP)            DisposeRoutineDescriptor(userUPP)
      #define InvokeFolderManagerNotificationUPP(message, arg, userRefCon, userUPP)  (OSStatus)CALL_THREE_PARAMETER_UPP((userUPP), uppFolderManagerNotificationProcInfo, (message), (arg), (userRefCon))
  endif
  /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  define NewFolderManagerNotificationProc(userRoutine)           NewFolderManagerNotificationUPP(userRoutine)
  define CallFolderManagerNotificationProc(userRoutine, message, arg, userRefCon) InvokeFolderManagerNotificationUPP(message, arg, userRefCon, userRoutine)
  enum {
      kFolderManagerNotificationMessageUserLogIn = FOUR_CHAR_CODE('log+'), /*    Sent by system & third party software after a user logs in.  arg should point to a valid FindFolderUserRedirectionGlobals structure or nil for the owner*/
      kFolderManagerNotificationMessagePreUserLogIn = FOUR_CHAR_CODE('logj'), /*    Sent by system & third party software before a user logs in.  arg should point to a valid FindFolderUserRedirectionGlobals structure or nil for the owner*/
      kFolderManagerNotificationMessageUserLogOut = FOUR_CHAR_CODE('log-'), /*    Sent by system & third party software before a user logs out.  arg should point to a valid FindFolderUserRedirectionGlobals structure or nil for the owner*/
      kFolderManagerNotificationMessagePostUserLogOut = FOUR_CHAR_CODE('logp'), /*    Sent by system & third party software after a user logs out.  arg should point to a valid FindFolderUserRedirectionGlobals structure or nil for the owner*/
      kFolderManagerNotificationDiscardCachedData = FOUR_CHAR_CODE('dche') /*    Sent by third party software when the entire Folder Manager cache should be flushed*/
  };
  
  /*  These get used in the options parameter of FolderManagerRegisterNotificationProc()*/
  enum {
      kDoNotRemoveWhenCurrentApplicationQuitsBit = 0,
      kDoNotRemoveWheCurrentApplicationQuitsBit = kDoNotRemoveWhenCurrentApplicationQuitsBit /*    Going away soon, use kDoNotRemoveWheCurrentApplicationQuitsBit*/
  };
  
  /*  These get used in the options parameter of FolderManagerCallNotificationProcs()*/
  enum {
      kStopIfAnyNotificationProcReturnsErrorBit = 31
  };