PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Procedure used to manage the different events that occur
  • Required configuration
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
BurnerErase (Function)
In French: GraveurEfface
Erases the files found on a rewritable CD or DVD. This CD (or DVD) must be inserted into the current burner.
A specifc WLanguage procedure is regularly called by BurnerErase during the erase process. This procedure is used to manage the different events that occur during the erase process.
Notes:
  • The burner can be selected by BurnerSelect.
  • This function is not locking. To find out whether the erase process is completed, use the WLanguage procedure regularly called by BurnerErase.
// Entirely erase the files found on CD
// The burner door will automatically opened at the end of erase process
ResErase is boolean
ResErase = BurnerErase(burnerFullErasing + burnerAutoEject, ProcCDErase)
// To view the entire example, click the "Example" link
Syntax
<Result> = BurnerErase([<Options of Erase Process> [, <Procedure Name> [, <Pointer>]]])
<Result>: Boolean
  • True if the files are currently erased from the CD/DVD,
  • False otherwise. To find out the error details, use ErrorInfo.
To find out whether the erase process is over, test the event that occurred in <Procedure Name>.
<Options of Erase Process>: Optional Integer constant (or combination of constants)
Options for erasing files from the CD/DVD:
burnerFullErasingFull erasing: the files are entirely deleted from the CD/DVD.
This method can take quite a long time but the deleted files cannot be restored.
burnerFastErasingFast erasing: the files are not entirely deleted from the CD/DVD. Only the references to the CD content will be deleted.
This method is faster but the files can be restored by a specific software. This method is not recommended if the files found on the CD/DVD contain confidential information.
burnerAutoEjectOpen the burner door at the end of erase process.
burnerNoEjectDon't open the burner door at the end of erase process.
By default, the erase process is fast and the burner door is not automatically opened at the end of the erase process.
<Procedure Name>: Optional character string (with or without quotes)
Name of WLanguage procedure ("callback") regularly called during the erase operation. This procedure is used to manage the different events that occur.
This procedure has the following format:
PROCEDURE <Procedure Name>(<Event that Occurred>,
<Event Message>, <Procedure Pointer>, <Parameter>)
The parameters of this procedure are optional.
There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled whenever a file is processed.
<Pointer>: Optional integer
Pointer passed to the <Procedure Name> procedure.
Remarks

Procedure used to manage the different events that occur

BurnerErase regularly calls the <Procedure Name> procedure. This procedure is used to manage the different events that occur during the erase process. This procedure is a local or global procedure.
This procedure must be declared as follows:
PROCEDURE <Procedure Name>(<Event that Occurred>, <Event Message>,
<Procedure Pointer>, <Parameter>)
  • <Event that Occurred> is a constant indicating the type of event.
  • <Event Message> is a character string that contains the message corresponding to the event that occurred.
  • <Procedure Pointer> is an integer whose value is the one passed to the <Pointer> parameter of BurnerErase. If <Pointer> is not specified, <Pointer> is set to 0.
  • <Parameter> is an integer containing a value specific to the event that occurred.
    The different values are as follows:
    Event<Event that Occurred><Event Message><Parameter>
    Cancel the erase processburnerNotificationCancel""0
    Deletion (only available on Vista or Windows XP + KB032716)burnerNotificationErasing""In this case, two parameters are managed:
    Parameter 1: Number of seconds since the beginning of the erase operation.
    Parameter 2: Estimated total duration of operation (may change during the erase operation)
    Caution: This information is returned by the burner and it may be invalid.
    Error foundburnerNotificationErrorError messageCode of error that occurred
    Erase operation completedburnerNotificationEndErasingError message if <Parameter> is different from 0, empty string ("") otherwiseReturn code, 0 if no error
    Other eventMessage of event0

    To retrieve the value of <Procedure Pointer>, the value of <Procedure Pointer> must be assigned to the value of <Pointer> in the procedure by Transfer.
Note: The parameters of this procedure are optional: you have the ability to specify the event and the message for example.

Required configuration

WINDEV Burning CDs is available for Windows XP and later. Burning DVDs is available for Windows Vista and for Windows XP when using the KB932716 update for Windows XP (this update must be downloaded from the Microsoft site and installed manually because it is not taken into account by the Live Update mechanism).
WEBDEV - Server code The CDs and the DVDs will be burned on the Web server. To burn CDs or DVDs, the server must be running Windows XP or later. To burn CDs in Windows 2003 Server, the IMAPI burn service (named "IMAPI CD-burning COM service") must be enabled. To burn DVDs in Windows 2003 Server, you also have to install the KB932716 update.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230grv.dll
Minimum required version
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment