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.
Applies To:
See Also
Reference
AddAlternatePublisher Method
EnumAlternatePublishers Method
RemoveAlternatePublisher Method