PBDTDeleteSync

PBDTDelete

Removes desktop database from a local volume

#include <Files.h> Finder Interface

OSErr PBDTDelete(paramBlock, async);

DTPBPtr paramBlock ; pointer to a DTPB Param Block

Boolean async; 0 = await completion; 1 = immediate return

The PBDTReset and PBDTDelete functions remove information from the

desktop database. Unless you are manipulating the desktop database in the

absence of the Finder, you should never use these functions.

Parameter block

€Æ 12 ioCompletion long completion routine

€¨ 16 ioResult short result code

€Æ 22 ioVRefNum short volume reference number

€Æ 26 ioIndex short must be 0

Note: Your application should never call PBDTDelete.

PBDTDelete removes the desktop database from a local volume. You specify

the volume by passing a volume reference number in ioVRefNum. You can call

PBDTDelete only when the database is closed.

Returns: an Error code. It will be one of the following:

noErr (0) No error

ioErr (-36) I/O error

wPrErr (-44) Volume is locked through hardware

vLckdErr (-46) Volume is locked through software

rfNumErr (-51) Reference number invalid

extFSErr (-58) External file system-file system identifier is nonzero

Note: There is a second, asynchronous, version of this function. It does not take a

second parameter; instead, it adds the suffix "Async" to the name of the

routine.

Similarly, the third (synchronous) version of the routine does not take a

second parameter; instead, it adds the suffix "Sync" to the name of the

routine.

Note, however, that the second and third versions of these routines do not

use the glue code that the first versions use and are therefore more

efficient.

Referenced by (4):