Database Property (SQL-DMO)

The Database property identifies a Microsoft® SQL Server™ database.

Applies To

Backup Object	Restore Object
Login Object

Syntax

object.Database [= value]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	String specifying a SQL Server database by name

Remarks

For a Login object, the Database property identifies the default database for the SQL Server login referenced.

For a Backup or Restore object, the Database property identifies the source or target database for a Transact-SQL BACKUP or RESTORE statement. The property is a required element and must be set prior to calling the SQLBackup method of the Backup object or the SQLRestore method of the Restore object.

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetDatabase(SQLDMO_LPBSTR pRetVal);

HRESULT SetDatabase(SQLDMO_LPCSTR NewValue);

Note SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference by using SysFreeString.