Important: The information in this document is obsolete and should not be used for new development.
PBResolveFileIDRef
You can use thePBResolveFileIDRef
function to retrieve the filename and parent directory ID of the file with a specified file ID.
FUNCTION PBResolveFileIDRef (paramBlock: HParmBlkPtr; async: Boolean): OSErr;
- paramBlock
- A pointer to an
fidParam
variant of the HFS parameter block.async
- A Boolean value that specifies asynchronous (
TRUE) or synchronous (FALSE) execution.
--> ioCompletion
ProcPtr
A pointer to a completion routine. <-- ioResult
OSErr
The result code of the function. <-> ioNamePtr
StringPtr
A pointer to a filename. --> ioVRefNum
Integer
A volume specification. <-- ioSrcDirID
LongInt
The file's parent directory ID. --> ioFileID
LongInt
A file ID. DESCRIPTION
ThePBResolveFileIDRef
function returns the filename and parent directory ID of the file referred to by file ID in theioFileID
field. It places the filename in the string pointed to by theioNamePtr
field and the parent directory ID in theioSrcDirID
field. If the name string isNIL
,PBResolveFileIDRef
returns only the parent directory ID. If the name string is notNIL
but is only a volume name,PBResolveFileIDRef
ignores the value in theioVRefNum
field, uses the volume name instead, and overwrites the name string with the filename. A return code offidNotFoundErr
means that the specified file ID reference has become invalid, either because the file was deleted or because the file ID reference was destroyed byPBDeleteFileIDRef
.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector forPBResolveFileIDRef
are
Trap macro Selector _HFSDispatch $0016 RESULT CODES