DiskNotEmpty event

Description

The DiskNotEmpty event is triggered when creating a spanned zip file and a non-empty disk is present or inserted into the removable media drive. This event is triggered only once per disk, right after the disk was requested by the InsertDisk event, but before writing any data to the disk.

The DiskNotEmpty event gives the host application a chance to perform various actions which might be necessary when a non-empty disk is present in the drive. The xAction parameter can be used when standard default actions to be taken (see below), or you may provide code for this event which performs custom actions. For example, you may want to create a separate "readme.txt" file or other data files on the disk before the actual zip file fills the disk space.

Declaration
Event DiskNotEmpty(xAction As xcdNotEmptyAction)

Declaration (DLL API)
xcdDiskNotEmptyParams * pParams = ( xcdDiskNotEmptyParams * ) lParam;

Parameters

Parameter	Modifiable	Description
xAction	YES	The action to take. Set it to xnaErase to erase the disk. Set it to xnaAppend to leave the files already on the disk alone, but fill up any remaining space with the zip file. Set it to xnaAskAnother to instruct the library to ask for another disk by triggering the InsertDisk event. Set it to xnaAbort to instruct the library to abort the current zipping operation.

Parameter

Modifiable

Description

xAction

YES

The action to take.

Set it to xnaErase to erase the disk.

Set it to xnaAppend to leave the files already on the disk alone, but fill up any remaining space with the zip file.

Set it to xnaAskAnother to instruct the library to ask for another disk by triggering the InsertDisk event.

Set it to xnaAbort to instruct the library to abort the current zipping operation.

Applicable methods

Zip