ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / CD and DVD burning functions
  • 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/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
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.
Remarks:
  • The burner can be selected by BurnerSelect.
  • This function is not locking. To find out if the deletion is complete, use the WLanguage procedure called regularly 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([<Erase options> [, <WLanguage procedure> [, <Pointer>]]])
<Result>: Boolean
  • True if the files are currently erased from the CD/DVD,
  • False otherwise. To get more details on the error, use ErrorInfo.
To determine if the erase process is over, test the event encountered in <Procedure name>.
<Erase options>: Optional Integer constant (or combination of constants)
Options for erasing files from the CD/DVD:
burnerAutoEjectOpen the burner door at the end of erase process.
burnerFastErasingQuick delete: 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.
burnerFullErasingFull delete: the files are entirely deleted from the CD/DVD.
This method can take quite a long time but the deleted files cannot be restored.
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.
<WLanguage procedure>: Name of optional procedure
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 encountered>,
<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 <Procedure name>.
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 encountered>, <Event message>,
<Procedure pointer>, <Parameter>)
  • <Event encountered> is a constant indicating the type of event.
  • <Event message> is a character string containing the message of the event encountered.
  • <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 encountered.
    The different values are as follows:
    Event<Event encountered><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 eventEvent message0

    To get the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer.
Remark: 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.
Component: wd290grv.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help