Database Property
The Database property identifies a Microsoft® SQL Server™ database.
Applies To
| Backup Object | Restore Object |
| Login Object |
Syntax
object.Database [= value]
Parts
object
Expression that evaluates to an object in the Applies To list
value
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-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 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.