AllowSyncToAlternate Property

SQL-DMO

SQL-DMO

AllowSyncToAlternate Property

The AllowSyncToAlternate property specifies whether to allow Subscribers to synchronize with an alternate Publisher. This is especially useful for pull subscriptions.

Applies To
MergePublication2 Object
Syntax

object.AllowSyncToAlternate [=value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetAllowSyncToAlternate(LPBOOL pRetVal);

HRESULT SetAllowSyncToAlternate(BOOL NewValue);

Remarks

Using alternate Publishers provides an efficient mechanism for synchronizing a mobile Subscriber that is not connected to the Publisher with which it ordinarily synchronizes data changes. Subscribers can synchronize with any listed alternate Publisher as long as it publishes the exact data and schema required by the subscription.

Set the AllowSyncToAlternate property to TRUE to allow Subscribers to synchronize with an alternate Publisher. A Publisher can run the EnumAlternatePublishers method of a MergePublication2 object to obtain a list of enabled alternate Publishers and potential alternate Publishers. Subscribers can run the EnumAlternatePublishers method of a MergePullSubscription2 object to obtain a list of enabled alternate Publishers.

Use the AddAlternatePublisher method to add a server to a list of enabled alternate Publishers.

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

See Also

AddAlternatePublisher Method

EnumAlternatePublishers Method

RemoveAlternatePublisher Method