Manager: File Manager


While Carbon supports most of the File Manager interface, there are a number of significant changes. The default volume format for Carbon is the Mac OS Extended format; in most cases you will not need to modify your application to gain this volume support, although Apple recommends that you adopt the new HFS Plus API introduced with Mac OS 9.0 to take full advantage of the capabilities of the Mac OS Extended format.

You should not access File Manager structures directly if accessor functions for the structure exist. For example, you should call PBGetFCBInfo rather than calling LMGetFCBSPtr and walking the FCB table.

Similarly, you should create file system specification (FSSpec) records using the functions PBMakeFSSpec or FSMakeFSSpec instead of filling in your own structures. File system specification records must contain a volume reference number, a parent directory, and a name. Substituting a working directory for the volume reference number or a full or partial pathname for the name is not supported.

File Manager functions that support MFS (the Macintosh file system) are not supported in Carbon. These include



Functions that cannot be called by PowerPC applications (such as PBGetAltAccessSync and PBGetAltAccessAsync) are not supported.

You should use only documented File Manager interfaces in your application. For example, you should use a documented API call to get low memory information rather than access undocumented low memory global variables or vectors directly.

Note that in current releases of Mac OS X (versions 10.0-10.1.x) File Manager file access permissions and byte range locking are not enforced across processes; it is possible for more than one process to open a file for writing simultaneously. If your application may have multiple clients accessing the same file simultaneously, you must synchronize the file accesses between these clients yourself. This only affects local volumes; file locking on AppleShare servers is still supported.

Supported  Allocate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  AllocContig

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CatMove

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  CloseWD

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  Create

This function is not supported in Carbon. Use the function FSpCreate instead. To create a file with a long Unicode filename, or a file that can grow beyond 2 GB, use the FSCreateFileUnicode function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  create

This function is not supported in Carbon. Use the function FSpCreate instead. To create a new file using long Unicode filenames on HFS Plus volumes, use the FSCreateFileUnicode function. Not available in CarbonLib. Not available in Mac OS X.

Supported  DirCreate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisposeFNSubscriptionUPP

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  DisposeIOCompletionUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  Eject

None of the eject functions are supported in Carbon. To unmount a volume, use the function UnmountVol. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  eject

None of the eject functions are supported in Carbon. To unmount a volume, use the function UnmountVol. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  FInitQueue

Not available in CarbonLib. Not available in Mac OS X.

Supported  FlushVol

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  flushvol

This function is not supported in Carbon. Use the function FlushVol instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  FNGetDirectoryForSubscription

Not available in CarbonLib. Available in Mac OS X 10.1 and later.

Supported  FNNotify

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  FNNotifyAll

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  FNNotifyByPath

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  FNSubscribe

Not available in CarbonLib. Available in Mac OS X 10.1 and later.

Supported  FNSubscribeByPath

Not available in CarbonLib. Available in Mac OS X 10.1 and later.

Supported  FNUnsubscribe

Not available in CarbonLib. Available in Mac OS X 10.1 and later.

Supported  FSAllocateFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCatalogSearch

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSClose

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSCloseFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCloseIterator

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCompareFSRefs

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCreateDirectoryUnicode

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCreateFileUnicode

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSCreateFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  fsdelete

This function is not supported in Carbon. Use the function FSpDelete instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  FSDelete

This function is not supported in Carbon. Use the function FSpDelete instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  FSDeleteFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSDeleteObject

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSExchangeObjects

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSFlushFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetCatalogInfo

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetCatalogInfoBulk

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetDataForkName

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetForkCBInfo

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetForkPosition

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetForkSize

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetResourceForkName

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSGetVolumeInfo

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSIterateForks

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSMakeFSRefUnicode

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSMakeFSSpec

Non-Carbon applications can also specify a working directory reference number in the vRefNum parameter. However, because working directories are not supported in Carbon, you cannot specify a working directory reference number if you wish your application to be Carbon-compatible. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSMoveObject

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  FSOpen

This function is not supported in Carbon. Use the function FSpOpenDF to open the data fork of a file on HFS volumes; use the function FSpOpenRF to open the resource fork of a file on HFS volumes.

To open a data or resource fork that is larger than 2 GB on an HFS Plus volume, use the FSOpenFork function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  fsopen

This function is not supported in Carbon. Use the function FSpOpenDF to open the data fork of a file, and use the function FSpOpenRF to open the resource fork of a file. To open a data or resource fork that is larger than 2 GB on an HFS Plus volume, use the FSOpenFork function. Not available in CarbonLib. Not available in Mac OS X.

Supported  FSOpenFork

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the FSOpenFork function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSOpenIterator

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSPathMakeRef

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  FSpCatMove

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpCreate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpDelete

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpDirCreate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpExchangeFiles

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpGetFInfo

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpMakeFSRef

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSpOpenDF

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpOpenRF

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpRename

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpRstFLock

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpSetFInfo

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSpSetFLock

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSRead

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSReadFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSRefMakePath

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Unsupported  fsrename

This function is not supported in Carbon. Use the function FSpRename instead. To rename a file or directory using long Unicode names, use the FSRenameUnicode function. Not available in CarbonLib. Not available in Mac OS X.

Supported  FSRenameUnicode

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSSetCatalogInfo

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSSetForkPosition

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSSetForkSize

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSSetVolumeInfo

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  FSWrite

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  FSWriteFork

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  GetEOF

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetFInfo

This function is not supported in Carbon. Use the function FSpGetFInfo instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  getfinfo

This function is not supported in Carbon. Use the function FSpGetFInfo instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetFPos

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetFSQHdr

Not supported in Carbon. Applications should not be using this function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetVCBQHdr

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetVInfo

This function is not supported in Carbon. Use the function PBHGetVInfoSync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  getvinfo

This function is not supported in Carbon. Use the functions PBHGetVInfoSync or PBHGetVInfoAsync instead. To get information about an HFS Plus volume, use the FSGetVolumeInfo function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  getvol

This function is not supported in Carbon. Use the function HGetVol instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  GetVol

This function is unsupported in Carbon. Instead, use the HGetVol function. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetVRefNum

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetWDInfo

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  HCreate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HDelete

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HGetFInfo

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HGetVol

Carbon applications should use HGetVol and HSetVol to get and set the default directory. the functions GetVol and SetVol, as well as working directories, are no longer supported. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HOpen

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the HOpen function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HOpenDF

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the HOpenDF function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HOpenRF

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the HOpenRF function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HRename

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HRstFLock

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HSetFInfo

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HSetFLock

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HSetVol

Carbon applications should use HGetVol and HSetVol to get and set the default directory. the functions GetVol and SetVol, as well as working directories, are no longer supported. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  InvokeFNSubscriptionUPP

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  InvokeIOCompletionUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewFNSubscriptionUPP

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  NewIOCompletionUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  OpenDF

This function is not supported in Carbon. Use the function FSpOpenDF instead. To open a data fork that is larger than 2 GB on an HFS Plus volume, use the FSOpenFork function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  OpenRF

This function is not supported in Carbon. Use the function FSpOpenRF instead. To open a resource fork larger than 2 GB on an HFS Plus volume, use the FSOpenFork function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  openrf

This function is not supported in Carbon. Use the function FSpOpenRF instead. To open a resource fork larger than 2 GB on an HFS Plus volume, use the FSOpenFork function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  OpenWD

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBAllocateAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBAllocateForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBAllocateForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBAllocateSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBAllocContigAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBAllocContigSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatalogSearchAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatalogSearchSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatMoveAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatMoveSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatSearchAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCatSearchSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCloseForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCloseForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCloseIteratorAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCloseIteratorSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBCloseWDAsync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBCloseWDSync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBCompareFSRefsAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCompareFSRefsSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBCreateAsync

This function is not supported in Carbon. Instead, you should use the PBHCreateAsync function. The PBCreateAsync function is identical to the PBHCreateAsync function, except that PBHCreateAsync takes a directory ID in the ioDirID field of the parameter block passed to it.

To create a file using long Unicode filenames, or a file that can grow beyond 2 GB, you should use the function PBCreateFileUnicodeAsync on HFS Plus volumes. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBCreateDirectoryUnicodeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateDirectoryUnicodeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateFileIDRefAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateFileIDRefSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateFileUnicodeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateFileUnicodeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBCreateForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBCreateSync

This function is not supported in Carbon. Instead, you should use the PBHCreateSync function. The PBCreateSync function is identical to the PBHCreateSync function, except that PBHCreateSync takes a directory ID in the ioDirID field of the parameter block passed to it.

To create a file using long Unicode filenames, or a file that can grow beyond 2 GB, you should use the function PBCreateFileUnicodeSync on HFS Plus volumes. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBDeleteAsync

This function is not supported in Carbon. Use the function PBHDeleteAsync instead. The PBDeleteAsync function is identical to the PBHDeleteAsync function, except that PBHDeleteAsync takes a directory ID in the ioDirID field of the parameter block passed to it, and can be used to delete an empty directory. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBDeleteFileIDRefAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDeleteFileIDRefSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDeleteForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBDeleteForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBDeleteObjectAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBDeleteObjectSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBDeleteSync

This function is not supported in Carbon. Use the function PBHDeleteSync instead. The PBDeleteSync function is identical to the PBHDeleteSync function, except that PBHDeleteSync takes a directory ID in the ioDirID field of the parameter block passed to it, and can be used to delete an empty directory. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBDirCreateAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDirCreateSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTAddAPPLAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTAddAPPLSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTAddIconAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTAddIconSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTCloseDown

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTDeleteAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTDeleteSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTFlushAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTFlushSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetAPPLAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetAPPLSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetCommentAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetCommentSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetIconAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetIconInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetIconInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetIconSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTGetPath

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTOpenInform

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTRemoveAPPLAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTRemoveAPPLSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTRemoveCommentAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTRemoveCommentSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTResetAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTResetSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTSetCommentAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBDTSetCommentSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBEject

None of the eject functions are supported in Carbon. To unmount a volume, use the function UnmountVol. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBExchangeFilesAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBExchangeFilesSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBExchangeObjectsAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBExchangeObjectsSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushFileAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushFileSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushVolAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBFlushVolSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBGetAltAccessAsync

68K-specific.

Unsupported  PBGetAltAccessSync

68K-specific.

Supported  PBGetCatalogInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetCatalogInfoBulkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetCatalogInfoBulkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetCatalogInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetCatInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetCatInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetEOFAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetEOFSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetFCBInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetFCBInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBGetFInfoAsync

This function is not supported in Carbon. Use the function PBHGetFInfoAsync instead.

To get information about files and directories on HFS Plus volumes, use the PBGetCatalogInfoAsync function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBGetFInfoSync

This function is not supported in Carbon. Use the function PBHGetFInfoSync instead.

To get information about files and directories on HFS Plus volumes, use the PBGetCatalogInfoSync function. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBGetForeignPrivsAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForeignPrivsSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkCBInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkCBInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkPositionAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkPositionSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkSizeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetForkSizeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetFPosAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetFPosSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetUGEntryAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetUGEntrySync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBGetVInfoAsync

This function is not supported in Carbon. Use the function PBHGetVInfoAsync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBGetVInfoSync

This function is not supported in Carbon. Use the function PBHGetVInfoSync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBGetVolAsync

This function is unsupported in Carbon. Instead, use the PBHGetVolAsync function. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBGetVolMountInfo

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetVolMountInfoSize

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBGetVolSync

This function is unsupported in Carbon. Instead, use the PBHGetVolSync function. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBGetVolumeInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetVolumeInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBGetWDInfoAsync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBGetWDInfoSync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBGetXCatInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  PBGetXCatInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  PBHCopyFileAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHCopyFileSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHCreateAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHCreateSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHDeleteAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHDeleteSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetDirAccessAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetDirAccessSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetFInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetFInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetLogInInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetLogInInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVolAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVolParmsAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVolParmsSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHGetVolSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMapIDAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMapIDSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMapNameAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMapNameSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMoveRenameAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHMoveRenameSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenAsync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenAsync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenDenyAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenDenySync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenDFAsync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenDFAsync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenDFSync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenDFSync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenRFAsync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenRFAsync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenRFDenyAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenRFDenySync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenRFSync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenRFSync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHOpenSync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBHOpenSync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHRenameAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHRenameSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHRstFLockAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHRstFLockSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetDirAccessAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetDirAccessSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetFInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetFInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetFLockAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetFLockSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetVolAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBHSetVolSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBHTrashVolumeCachesSync

This function is not supported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBIterateForksAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBIterateForksSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBLockRangeAsync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible to have multiple writers for the same file. Locking a portion of a file with PBLockRangeAsync does not guarantee exclusive access to that part of the file. If you call PBLockRangeAsync to lock a portion of a file to which another process already has write access, the call will succeed without error. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBLockRangeSync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible to have multiple writers for the same file. Locking a portion of a file with PBLockRangeSync does not guarantee exclusive access to that part of the file. If you call PBLockRangeSync to lock a portion of a file to which another process already has write access, the call will succeed without error. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSRefAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSRefSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSRefUnicodeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSRefUnicodeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSSpecAsync

Non-Carbon applications can also specify a working directory reference number in the ioVRefNum field. However, because working directories are not supported in Carbon, you cannot specify a working directory reference number if you wish your application to be Carbon-compatible. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBMakeFSSpecSync

Non-Carbon applications can also specify a working directory reference number in the ioVRefNum field. However, because working directories are not supported in Carbon, you cannot specify a working directory reference number if you wish your application to be Carbon-compatible. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBMountVol

Not available in CarbonLib. Not available in Mac OS X.

Supported  PBMoveObjectAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBMoveObjectSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBOffLine

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBOpenDFAsync

This function is not supported in Carbon. Instead, use the function PBHOpenDFAsync to open the data fork of a file on HFS volumes. The PBOpenDFAsync function is identical to the PBHOpenDFAsync function, except that PBHOpenDFAsync takes a directory ID in the ioDirID field of the parameter block passed to it.

To open a data fork larger than 2 GB on HFS Plus volumes, use the function PBOpenForkAsync. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBOpenDFSync

This function is not supported in Carbon. Use the function PBHOpenDFSync to open the data fork of a file on HFS volumes. The PBOpenDFSync function is identical to the PBHOpenDFSync function, except that PBHOpenDFSync takes a directory ID in the ioDirID field of the parameter block passed to it.

To open a data fork larger than 2 GB on HFS Plus volumes, use the function PBOpenForkSync. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBOpenForkAsync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBOpenForkAsync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBOpenForkSync

In current releases of Mac OS X (Mac OS X, versions 10.0 - 10.1.x) it is possible for more than one process to have the same file open with write permission simultaneously. If your application requests write permission for a file to which another process already has write access, the PBOpenForkSync function opens the file and returns noErr. Note that this only affects local volumes; file locking access on AppleShare servers is still supported. For more information, see technote TN2037 at:

http://developer.apple.com/technotes/indexes/fl-a.html

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBOpenIteratorAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBOpenIteratorSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBOpenRFAsync

This function is not supported in Carbon. Instead, use the function PBHOpenRFAsync to open the resource fork of a file on HFS volumes. The PBOpenRFAsync function is identical to the PBHOpenRFAsync function, except that PBHOpenRFAsync takes a directory ID in the ioDirID field of the parameter block passed to it.

To open a resource fork larger than 2 GB on HFS Plus volumes, use the function PBOpenForkAsync. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBOpenRFSync

This function is not supported in Carbon. Instead, use the function PBHOpenRFSync to open the resource fork of a file on HFS volumes. The PBOpenRFSync function is identical to the PBHOpenRFSync function, except that PBHOpenRFSync takes a directory ID in the ioDirID field of the parameter block passed to it.

To open a resource fork larger than 2 GB on HFS Plus volumes, use the function PBOpenForkSync. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBOpenWDAsync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBOpenWDSync

Working directories are unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBReadForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBReadForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBRenameAsync

This function is not supported in Carbon. Use the function PBHRenameAsync instead.

To rename a file or directory using a long Unicode name on HFS Plus volumes, use the PBRenameUnicodeAsync function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBRenameSync

This function is not supported in Carbon. Use the function PBHRenameSync instead.

To rename a file or directory using a long Unicode name on HFS Plus volumes, use the PBRenameUnicodeSync function. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBRenameUnicodeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBRenameUnicodeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBResolveFileIDRefAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBResolveFileIDRefSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBRstFLockAsync

This function is not supported in Carbon. Use the function PBHRstFLockAsync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBRstFLockSync

This function is not supported in Carbon. Use the function PBHRstFLockSync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetAltAccessAsync

68K-specific.

Unsupported  PBSetAltAccessSync

68K-specific.

Supported  PBSetCatalogInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetCatalogInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetCatInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetCatInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetEOFAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetEOFSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBSetFInfoAsync

This function is not supported in Carbon. Use the function PBHSetFInfoAsync instead.

To set information about files and directories on HFS Plus volumes, use the PBSetCatalogInfoAsync function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetFInfoSync

This function is not supported in Carbon. Use the function PBHSetFInfoSync instead.

To set information about files and directories on HFS Plus volumes, use the PBSetCatalogInfoSync function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetFLockAsync

This function is not supported in Carbon. Use the function PBHSetFLockAsync instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetFLockSync

This function is not supported in Carbon. Use the function PBHSetFLockSync instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBSetForeignPrivsAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetForeignPrivsSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetForkPositionAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetForkPositionSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetForkSizeAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetForkSizeSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetFPosAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetFPosSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBSetFVersAsync

This function has no effect on a hierarchical file system; it is a relic of the Macintosh File System (MFS) and is unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetFVersSync

This function has no effect on a hierarchical file system; it is a relic of the Macintosh File System (MFS) and is unsupported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBSetVInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetVInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBSetVolAsync

This function is unsupported in Carbon. Instead, use the PBHSetVolAsync function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  PBSetVolSync

This function is unsupported in Carbon. Instead, use the PBHSetVolSync function. Not available in CarbonLib. Not available in Mac OS X.

Supported  PBSetVolumeInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBSetVolumeInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBShareAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBShareSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBUnlockRangeAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBUnlockRangeSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBUnmountVol

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  PBUnmountVolImmed

Not available in CarbonLib. Not available in Mac OS X.

Supported  PBUnshareAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBUnshareSync

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBVolumeMount

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PBWriteForkAsync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBWriteForkSync

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Supported  PBXGetVolInfoAsync

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  PBXGetVolInfoSync

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  rename

Unsupported  Rename

This function is not supported in Carbon. Use the function FSpRename instead. To rename a file or directory using long Unicode names, use the FSRenameUnicode function. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  RstFLock

This function is not supported in Carbon. Use the function FSpRstFLock instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  rstflock

This function is not supported in Carbon. Use the function FSpRstFLock instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetEOF

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  SetFInfo

This function is not supported in Carbon. Use the function FSpSetFInfo instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  setfinfo

This function is not supported in Carbon. Use the function FSpSetFInfo instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SetFLock

This function is not supported in Carbon. Use the function FSpSetFLock instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  setflock

This function is not supported in Carbon. Use the function FSpSetFLock instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetFPos

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  setvol

This function is not supported in Carbon. Use the function HSetVol instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  SetVol

This function is unsupported in Carbon. Instead, use the HSetVol function. Not available in CarbonLib. Not available in Mac OS X.

Supported  UnmountVol

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  unmountvol

This function is not supported in Carbon. Use the function UnmountVol instead. Not available in CarbonLib. Not available in Mac OS X.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.