PhysicalName Property

SQL-DMO

SQL-DMO

PhysicalName Property

The PhysicalName property specifies the path and file name of the operating system file storing Microsoft® SQL Server™ database or transaction log data.

Applies To
DBFile Object LogFile Object
Syntax

object.PhysicalName [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that specifies an operating system file

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetPhysicalName(SQLDMO_LPBSTR pRetVal)

HRESULT SetPhysicalName(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 reference must release the reference using SysFreeString.

Remarks

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

Specify an operating system file using either drive and directory-based or UNC file naming. For example, the strings C:\Program Files\Microsoft SQL Server\Data\Northwnd.mdf and \\Seattle1\Program Files\Microsoft SQL Server\Data\Northwnd.mdf are each valid for PhysicalName.