PhysicalLocation Property

SQL-DMO

SQL-DMO

PhysicalLocation Property

The PhysicalLocation property specifies an operating system name that identifies a backup device.

Applies To
BackupDevice Object
Syntax

object.PhysicalLocation [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that identifies an operating system file or tape device

Data Type

String

Modifiable

Read/write before device creation. Read-only when referencing an existing backup device.

Prototype (C/C++)

HRESULT GetPhysicalLocation(SQLDMO_LPBSTR pRetVal)

HRESULT SetPhysicalLocation(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

The PhysicalLocation property is a string with a maximum of 260 characters.

Specify an operating system file or tape using a UNC string. For example, the string \\Seattle1\Backups\Northwind.bak specifies a server name, directory, and file name for a backup device. The string \\.\TAPE0 specifies a server and a file device, most likely a tape, as a backup device.