SubsetFilterClause 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 SubsetFilterClause property specifies a Transact-SQL WHERE clause used to partition data horizontally in the merge replication article.


.SubsetFilterClause [=value]


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

  • value
    A string of 1,002 characters or fewer that specifies a Transact-SQL WHERE clause

Data Type




Prototype (C/C++)

HRESULT GetSubsetFilterClause(SQLDMO_LPBSTR pRetVal);
HRESULT SetSubsetFilterClause(SQLDMO_LPCSTR NewValue);


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.


If an application sets SubsetFilterClause after the initial snapshot has been created, a new snapshot must be generated and then reapplied to each subscription. Snapshots are applied when the next scheduled snapshot and merge agent run.

Applies To: