Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Files /
Chapter 2 - File Manager / File Manager Reference
File ID Routines / Creating and Deleting File ID References


PBDeleteFileIDRef

You can use the PBDeleteFileIDRef function to delete a file ID reference.

FUNCTION PBDeleteFileIDRef (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.
-->ioCompletionProcPtrA pointer to a completion routine.
<--ioResultOSErrThe result code of the function.
-->ioNamePtrStringPtrA pointer to a filename.
-->ioVRefNumIntegerA volume specification.
-->ioFileIDLongIntA file ID.

DESCRIPTION
The PBDeleteFileIDRef function invalidates the specified file ID reference on the volume specified by ioVRefNum or ioNamePtr. After it has invalidated a file ID
reference, the File Manager can no longer resolve that ID reference to a filename and
parent directory ID.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for PBDeleteFileIDRef are
Trap macroSelector
_HFSDispatch$0015

RESULT CODES
noErr0No error
nsvErr-35Volume not found
ioErr-36I/O error
fnfErr-43File not found
wPrErr-44Hardware volume lock
vLckdErr-46Software volume lock
paramErr-50Function not supported by volume
volOfflinErr-53Volume is offline
extFSErr-58External file system
wrgVolTypErr-123Function is not supported by volume
fidNotFoundErr-1300File ID not found
afpAccessDenied-5000User does not have the correct access
afpObjectTypeErr-5025Specified file is a directory
afpIDNotFound-5034File ID not found

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996