Initialize Method (Replication ActiveX)

The Initialize method validates the control properties and establishes all database connections.

Syntax

object.Initialize 
Part Description

object

Expression that evaluates to an object in the Applies To list.

Applies To

SQLDistribution Object (Replication ActiveX)

SQLMerge Object (Replication ActiveX)

Return Value

Return code Description

S_OK

Method succeeded.

E_FAIL

General failure occurred. Check error records for detailed information.

REPLX_E_DBNOTFOUND

Specified database does not exist.

REPLX_E_SUBNOTFOUND

Specified subscription does not exist.

REPLX_E_SUBEXPIRED

Subscription has expired.

REPLX_E_PROFILENOTFOUND

Specified profile does not exist.

REPLX_E_RETRYFAILURE

Failure occurred that might require retrying the last operation.

Remarks

Control properties that define the Publisher, publication, Distributor, and Subscriber (for the Distribution and Merge controls) must be set before calling Initialize.

In Microsoft Visual Basic, Initialize is a Sub method and does not return a value.

Initialize should not be called prior to using the AddSubscription Method (Replication ActiveX) method to add a new subscription, prior to using the DropSubscription Method (Replication ActiveX) method to drop an existing subscription, or prior to using CopySubscription Method (Replication ActiveX) to copy a subscription database.

Prototype (C/C++)

HRESULT Initialize( );

See Also

Concepts

Programming Replication Using ActiveX Controls

Help and Information

Getting SQL Server 2005 Assistance