PBResolveFileIDRefSync
PBResolveFileIDRef Retrieve the filename and parent directory ID
OSErr PBResolveFileIDRef (pb, async ); Boolean async ; 0=await completion; 1=immediate return Use the PBResolveFileIDRef function to to retrieve the filename and
parent directory ID of the file with a specified file ID.
pb is a pointer to a FIDParam structure.The relevant fields are as follows:
Æ ioCompletion ProcPtr 4 12 pointer to completion routine ¨ ioResult short 2 16 result code
´ ioNamePtr StringPtr 4 18 pointer to first filename Æ ioVRefNum short 2 22 volume specification (volume reference number,
working directory reference number, drive
number, or 0 for default volume)
ۮ ioFileID long 4 54 file ID
async is a Boolean value. Use FALSE for normal (synchronous) operation or TRUE to enqueue the request and resume control immediately. See Async I/O.
noErr (0) No error
nsvErr (-35) Volume not found
ioErr (-36) I/O error
fnfErr (-43) File not found
volOfflinErr (-53) Volume is off line
extFSErr (-58) External file system
wrgVolTypeErr (-123) Not an HFS volume
fidNotFoundErr (-1300) File ID not found
notAFileErr (-1302) Specified file is a directory
Notes: PBResolveFileIDRef returns the filename and parent directory ID of
the file referred to by file ID in the ioFileID field. It places the filename in
the string pointed to by the ioNamePtr field and the parent directory ID in
the ioSrcDirID field. If the name string is NIL, PBResolveFileIDRef
returns only the parent directory ID. If the name string is not NIL but is
only a volume name, PBResolveFileIDRef ignores the value in the
ioVRefNum field, uses the volume name instead, and overwrites the name
string with the filename. A return code of fidNotFoundErr means that the
specified file ID has become invalid, either because the file was deleted or