Initialize Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The Initialize property controls backup device append and overwrite behavior for a backup to one or more specified devices.

Syntax

object.Initialize [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetInitialize(LPBOOL pRetVal);
HRESULT SetInitialize(BOOL NewValue);

Remarks

If TRUE, the backup specified becomes the first backup set on the media, overwriting any existing backup sets on the media. The backup media is not overwritten if either of the following conditions is met:

  • All backup sets on the media have not yet expired.

  • The optionally specified backup set name does not match the name on the backup media. Specify backup set name with the BackupSetName property.

If FALSE, the backup specified creates a new backup set and appends it as the last backup set on the media.

Applies To: