• Article

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.