DataFile Property (SQL-DMO)

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]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	String identifying an operating system file by name

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.

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 by using SysFreeString.