|
|
|
|
|
|
|
|
|
|
- Procedure used to manage the different events that occur
- Required configuration
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.
ResErase is boolean
ResErase = BurnerErase(burnerFullErasing + burnerAutoEject, ProcCDErase)
Sintaxis
<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: | | | burnerAutoEject | Open the burner door at the end of erase process. | | burnerFastErasing | Quick erase: files are not completely 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. | | burnerFullErasing | Complete deletion: the files are actually deleted from the CD/DVD. This method can take quite a long time but the deleted files cannot be restored. | | burnerNoEject | Don'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 the 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>. Observaciones 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 process | burnerNotificationCancel | "" | 0 | | Deletion (only available on Vista or Windows XP + KB032716) | burnerNotificationErasing | "" | In this case, two parameters are managed:
Parameter 1: Number of seconds elapsed since the start of deletion.
Parameter 2: Estimated total operation time (may vary during deletion)
Warning: This information is returned by the engraver and may be erroneous. | | Error found | burnerNotificationError | Error message | Code of error that occurred | | Erase operation completed | burnerNotificationEndErasing | Error message if <Parameter> is different from 0, empty string ("") otherwise | Return code, 0 if no error | | Other event | | Event message | 0 |
To get the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer.
Note: The parameters of this procedure are optional: for example, you can specify only the event and the message.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|