PBDTResetSync

PBDTReset

Removes icons, application mappings and comments

#include <Files.h> Finder Interface

OSErr PBDTReset(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

€Æ 24 ioDTRefNum short database reference number

€Æ 26 ioIndex short must be 0

Note: Your application should never call PBDTReset.

PBDTReset removes all icons, application mappings, and comments from the

desktop database specified in ioDTRefNum. You can call PBDTReset only when

the database is open. It remains open after the data is cleared.

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):