• Article

DestinationObjectName 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 DestinationObjectName property specifies the name of table or stored procedure created as the target of a transactional replication article.

Syntax

object.DestinationObjectName [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A string that specifies a valid Microsoft SQL Server table or stored procedure name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetDestinationObjectName(SQLDMO_LPBSTR pRetVal);
HRESULT SetDestinationObjectName(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

For a TransArticle object, the SourceObjectName property provides the default for DestinationObjectName.

Specify an alternate owner for the published object using the DestinationOwnerName property.

Although the DestinationObjectName property is a read/write property of the TransArticle object, setting DestinationObjectName for a MergeArticle2 object has no effect. The value of the DestinationObjectName property of the MergeArticle2 object is always the same as the value of the SourceObjectName property.

Note

If an application sets DestinationObjectName with the TransArticle object after the initial snapshot has been created, a new snapshot must be generated and reapplied to each subscription. Snapshots are applied when the next scheduled snapshot and distribution agent run.