<Connection variable>.RetrieveBackup (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

HFSQL Client/Server functions

Rights required to retrieve a backup

See also

ActivateServerTrigger

AddGroup

AddLink

AddScheduledBackup

AddScheduledOptimization

DeactivateServerTrigger

DeleteScheduledBackup

DeleteScheduledOptimization

DescribeServerTrigger

ExecuteScheduledBackup

ListScheduledOptimization

ModifyDatabaseProperty

ModifyScheduledBackup

ModifyScheduledOptimization

NotifAddEmailRecipient

NotifConfigure

NotifDeleteCCRecipient

NotifDeleteEmailRecipient

NotifListCCRecipient

NotifListEmailRecipient

Rights required to retrieve a backup

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Connection variable>.RetrieveBackup (Function)

In french: <Variable Connexion>.RécupèreSauvegarde

Available only with this kind of connection

Retrieves locally the content of a compressed backup (in ZIP format) performed on a HFSQL server.

Example

// Describe the connection
MyConnection is Connection

MyConnection.RetrieveBackup(BackupID, "C:\temp\Myfile.zip", PROGBAR_Progress)

Syntax

<Result> = <Connection>.RetrieveBackup(<Backup> , <Destination file> [, <Progress Bar>])

<Result>: Boolean

True if the backup was retrieved,
False if a problem occurred. HErrorInfo is used to identify the error.

<Connection>: Connection variable

Name of the Connection variable that describes the connection with the backup to retrieve.

<Backup>: Integer or character string

Backup to retrieve. Can correspond to:
Backup identifier. This identifier can correspond to the identifier of full backup or to the identifier of differential backup.
During an immediate backup, this identifier is returned by <Connection variable>.Backup. This identifier can also be returned by <Connection variable>.InfoBackup.
During a scheduled backup, this identifier corresponds to the ..Identifier property of the hBackupDescription variable.
Path and name of backup. This name was specified during the backup. This name can also be returned by <Connection variable>.InfoBackup. If this name corresponds to a relative path, the backup will be sought in the "Backup" sub-directory of HFSQL server. To specify the directory of Manta service, all you have to do is use "%%EXE%%".

<Destination file>: Character string (with quotes)

Path and name of local file in which the backup will be retrieved.
In the case of a full backup, the destination file is a zip file (the ".zip" extension must be specified in the file name.

<Progress Bar>: Optional control name, optional window name or optional integer

Name of window where the progress bar will be displayed or name of Progress Bar control.
Identifier (Handle) of window that displays the progress bar.
This parameter is ignored.

Remarks

Versions 23 and later

Rights required to retrieve a backup

To retrieve a backup, the user or the group must have the rights to perform backups (hRightsBackup constant). These rights apply to the servers and to the databases. For example, to perform a full server backup, you must have the rights to perform backups at server level.

To find out whether these rights are granted to a user or to a group, use <Connection variable>.InfoServerRights or <Connection variable>.InfoDatabaseRights.

To modify the rights granted to a user or to a group of users, use <Connection variable>.ModifyServerRights or <Connection variable>.ModifyDatabaseRights.

New in version 23

Rights required to retrieve a backup

To find out whether these rights are granted to a user or to a group, use <Connection variable>.InfoServerRights or <Connection variable>.InfoDatabaseRights.

To modify the rights granted to a user or to a group of users, use <Connection variable>.ModifyServerRights or <Connection variable>.ModifyDatabaseRights.

Rights required to retrieve a backup

To find out whether these rights are granted to a user or to a group, use <Connection variable>.InfoServerRights or <Connection variable>.InfoDatabaseRights.

To modify the rights granted to a user or to a group of users, use <Connection variable>.ModifyServerRights or <Connection variable>.ModifyDatabaseRights.

Component : wd260hf.dll