Database 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 Database property identifies a Microsoft SQL Server database.

Syntax

object
.Database [=value]

Parts

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

• value
  A string that specifies a SQL Server database by name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetDatabase(SQLDMO_LPBSTR pRetVal);
HRESULT SetDatabase(SQLDMO_LPCSTR NewValue);

Note

SQL Distributed Management Objects (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 using SysFreeString.

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 Databaseproperty identifies the source or target database for a Transact-SQL BACKUP or RESTORE statement. The property is a required element and must be set before the SQLBackup method of the Backup object or the SQLRestore method of the Restore object is called.

Applies To:

Backup Object	Restore Object
Login Object