AllowSyncToAlternate 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 AllowSyncToAlternate property specifies whether to allow Subscribers to synchronize with an alternate Publisher. This ability is especially useful for pull subscriptions.

Syntax

object.AllowSyncToAlternate [=value]

Parts

  • object
    An 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 or later" are returned.