BurnerAddFile (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / CD and DVD burning functions

Compilation
Adding several identical files
Required configuration

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BurnerAddFile (Function)

In french: GraveurAjouteFichier

Adds a file to the compilation. When all the requested files have been added to the compilation, the CD/DVD can be burned (BurnerSave).

Remark: To add all the files in a directory to the compilation, use function BurnerAddDirectory.

Example

See additional examples

// Gravure d'un CD de type données 
BurnerMediaType(mediaType_CD_ROM_XA) 
// Ajout de fichiers 
ResAjout is boolean 
ResAjout = BurnerAddFile("C:\MonRépertoire\MonFichierA.TXT", "\MesFichiers\FicA.TXT") 
ResAjout = BurnerAddFile("C:\MonRépertoire\MonFichierB.TXT", "\MesFichiers\FicB.TXT") 
// Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"

// Gravure d'un CD de type audio
BurnerMediaType(mediaType_CDDA_CDROM) 
// Ajout de fichiers 
ResAjout is boolean 
ResAjout = BurnerAddFile("C:\MesMusiques\MaChansonA.WAV") 
ResAjout = BurnerAddFile("C:\MesMusiques\MaChansonB.WAV") 
// Pour visualiser cet exemple en totalité, cliquez sur le lien "Exemple"

Syntax

<Result> = BurnerAddFile(<File to add> [, <File on CD or DVD>])

<Result>: Boolean

True if the file was added to the compilation,
False otherwise. To get more details on the error, use ErrorInfo.
Note: A CD or DVD must be present in the recorder.. This CD or DVD must have enough space to burn a new session.

<File to add>: Character string

Name and path of file that will be added into the compilation (up to 260 characters). A full path, a relative path or a UNC path can be used.
For an audio compilation, these files must correspond to ".WAV" files (44100 Hz, 16 bits).
The file path is relative to the Web server.

<File on CD or DVD>: Optional character string

Name and path of file on the CD or DVD. This path must start with a backslash character ("\").
By default, the file will be added at the root of the CD/DVD.
This parameter is ignored for an audio compilation. Indeed, the file will be automatically added at the root of the CD/DVD.

Remarks

Compilation

A compilation corresponds to the set of files that must be burned on a CD or DVD. This compilation will be taken into account next time BurnerSave is called.

A compilation is automatically created during the first call to BurnerAddFile or BurnerAddDirectory. A single compilation can be created at a time.

A compilation is automatically deleted:

when changing the type of CD/DVD to burn (BurnerMediaType).
when selecting the default burner (BurnerSelect).
after the call to BurnerSave (only if the burn process was started, <Result> is set to True).
when canceling the burn process (BurnerCancel).
when closing the current WINDEV application or WEBDEV website.

Adding several identical files

If the same file is added several times to the compilation:

in the case of an audio CD/DVD: this file will be present on the CD/DVD as many times as it has been added.
in the case of a data CD/DVD: only the last file added (same name, same directory on the CD/DVD) will be present on the CD/DVD.

Required configuration

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

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: wd300grv.dll