SubsetFilterClause Property

SQL-DMO

SQL-DMO

SubsetFilterClause Property

The SubsetFilterClause property specifies a Transact-SQL WHERE clause used to partition data horizontally in the merge replication article.

Applies To
MergeArticle Object
Syntax

object.SubsetFilterClause [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String of 1,002 characters or less that specifies a Transact-SQL WHERE clause

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetSubsetFilterClause(SQLDMO_LPBSTR pRetVal);

HRESULT SetSubsetFilterClause(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

If an application sets SubsetFilterClause 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 merge agent run.