DataFile Property

SQL-DMO

SQL-DMO

DataFile Property

The DataFile property specifies the operating system name of the primary file implementing the referenced Microsoft® SQL Server™ replication distribution database.

Applies To
DistributionDatabase Object
Syntax

object.DataFile [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that identifies an operating system file by name

Data Type

String

Modifiable

Read/write when using the DistributionDatabase object to create a replication distribution database. Read-only when a DistributionDatabase object references an existing SQL Server database.

Prototype (C/C++)

HRESULT GetDataFile(SQLDMO_LPBSTR pRetVal);

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

Data storage for a SQL Server database is implemented in one or more operating system files. One operating system file maintains database-specific system table data and is identified as the primary database file.

When using the DistributionDatabase object to create a replication distribution database, fully specify an operating system file by setting the DataFolder and DataFile properties.

See Also

DataFolder Property