SkipTapeHeader Property

SQL-DMO

SQL-DMO

SkipTapeHeader Property

The SkipTapeHeader property enables or disables backup operation logic that verifies that correct media is loaded.

Applies To
Backup Object
Syntax

object.SkipTapeHeader [= value]

Parts

object

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 GetSkipTapeHeader(LPBOOL pRetVal);

HRESULT SetSkipTapeHeader(BOOL NewValue);

Remarks

If TRUE, a media name recorded on the media is not checked. The backup set is appended to the media.

If FALSE, a recorded media name is checked. When using SQL-DMO to perform a backup, provide the media name using the MediaName property. FALSE is the default value.

Note  SQL-DMO implements backup media initialization using the Initialize property. When Initialize is TRUE, SkipTapeHeader enables or disables logic that prevents overwrite of unexpired backup sets on a media. For more information, see BACKUP.