ReSynchronizeSubscription Method
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 ReSynchronizeSubscription method resynchronizes a subscription with all changes made at the Publisher and other Subscribers since a specified time.
Syntax
object
.ReSynchronizeSubscription(
szSubscriberName
,
szSubscriberDB
,
ResyncType
,
[ szDateTime ] )
Parts
- object
Expression that evaluates to an object in the Applies To list.
- szSubscriberName
String that specifies the Subscriber name.
- szSubscriberDB
String that specifies the subscription database name.
- ResyncType
Long integer that specifies which changes are applied when the subscription is resynchronized.
- szDateTime
String that specifies the date and time.
Prototype (C/C++)
HRESULT ReSynchronizeSubscription(
SQLDMO_LPCSTR pszSuscriberName,
SQLDMO_LPCSTR pszSubscriberDB,
SQLDMO_RESYNC_TYPE ResyncType,
SQLDMO_LPCSTR pszDateTime);
Settings
Set the ResyncType parameter by using these SQLDMO_RESYNC_TYPE values.
| Constant | Value | Description |
|---|---|---|
SQLDMOResync_/SinceAGivenDateTime |
2 |
Resynchronize subscription with all changes since a given date and time. |
SQLDMOResync_/SinceLastSnapshotApplied |
0 |
Resynchronize subscription with all changes since last snapshot was applied. |
SQLDMOResync_/SinceLastSuccessfulValidation |
1 |
Resynchronize subscription with all changes since last successful validation was performed. |
Remarks
By default, szDateTime is an optional parameter set to NULL. However, if ResyncType is set to SQLDMOResync_SinceAGivenDateTime, szDateTime is required and cannot be set to NULL. The date and time data must be formatted as YYYYMMDD hh:mm:ss.fff.
| Date part | Description |
|---|---|
YYYY |
Represents the year in four digits. |
MM |
Represents the month in two digits (zero padded). |
DD |
Represents the day of the month in two digits (zero padded). |
hh |
Represents the hour using two digits, a twenty-four hour clock (zero padded). |
mm |
Represents the minute in two digits (zero padded). |
ss |
Represents the second in two digits (zero padded). |
fff |
Represents the fractional part of the second in three digits. |
For example, the value 20040512 18:12:00.000 is interpreted as 6:12 P.M., May 12, 2004.
An application can call the ReadLastValidationDateTimes method to determine the date and time of the last successful validation of the subscription.
ReSynchronizeSubscription should be called at the Publisher.
Note
If an application calls ReSynchronizeSubscription 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 or later" are returned.
Applies To:
See Also
Reference
ReadLastValidationDateTimes Method