DataFile Property
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The DataFile property specifies the operating system name of the primary file implementing the referenced Microsoft SQL Server replication distribution database.
Syntax
object
.DataFile [=value]
Parts
- object
An expression that evaluates to an object in the Applies To list
- value
A string that identifies an operating system file by name
Data Type
String
Modifiable
Read/write if the DistributionDatabase object is used to create a replication distribution database. Read-only if a DistributionDatabase object references an existing SQL Server database.
Prototype (C/C++)
HRESULT GetDataFile(SQLDMO_LPBSTR pRetVal);
HRESULT SetDataFile(SQLDMO_LPCSTR NewValue);
Note
SQL Distributed Management Objects (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.