DestinationObjectName Property

SQL-DMO

SQL-DMO

DestinationObjectName Property

The DestinationObjectName property specifies the name of table or stored procedure created as the target of a transactional replication article.

Applies To
MergeArticle2 Object TransArticle Object
Syntax

object.DestinationObjectName [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

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-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.

See Also

DestinationOwnerName Property

SourceObjectName Property