JoinArticleName 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 JoinArticleName property identifies a source article for some types of merge replication horizontal partitioning.

Syntax

object
.JoinArticleName [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    A string identifying an existing merge replication article by name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetJoinArticleName(SQLDMO_LPBSTR pRetVal);
HRESULT SetJoinArticleName(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 by using SysFreeString.

Remarks

Use the MergeSubsetFilter object to horizontally partition data in a merge replication article if the partitioning WHERE clause is defined in a second article.

Note

If an application sets JoinArticleName after the initial snapshot has been created, a new snapshot must be generated. Snapshots are applied when the next scheduled snapshot agent runs.

Applies To:

MergeSubsetFilter Object