RemoveDefunctAnonymousSubscription Method

SQL-DMO

SQL-DMO

RemoveDefunctAnonymousSubscription Method

The RemoveDefunctAnonymousSubscription method removes a defunct anonymous subscription agent entry from the Distributor.

Applies To
Distributor2 Object
Syntax

object.RemoveDefunctAnonymousSubscription(
bstrDistributionDBName ,
lAgentID
,
ReplType
)

Parts

object

Expression that evaluates to an object in the Applies To list

bstrDistributionDBName

String that specifies the distribution database name

lAgentID

Long integer that identifies the agent for anonymous subscription

ReplType

Long integer that specifies a replication method

Prototype (C/C++)

HRESULT RemoveDefunctAnonymousSubscription(
SQLDMO_LPCSTR pszDistributionDBName,
long lAgentID,
SQLDMO_REPLICATION_TYPE ReplType);

Settings

Set ReplType by using these SQLDMO_REPLICATION_TYPE values.

Constant Value Description
SQLDMORepType_Merge 2 Merge replication
SQLDMORepType_Transactional 1 Transactional or snapshot replication

Remarks

An anonymous subscription becomes defunct when dropped by the Subscriber. If the Subscriber is not connected to the Distributor when the subscription is dropped, agent meta data still remains at the Distributor. An application can call RemoveDefunctAnonymousSubscription to clean up the meta data.

Note  If an application calls RemoveDefunctAnonymousSubscription on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.