다음을 통해 공유

  • 아티클

ValidateSubscriptions Method

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

The ValidateSubscriptions method invokes inline validation for one or more specified subscriptions.

구문

object
.ValidateSubscriptions(
szSubscriberNames
,
szSubscriberDBs
, 
[ ValidationOption ] , [ ValidationMethod ] , [ fShutDownAgent ] )

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • szSubscriberNames
    SQL Distributed Management Objects (SQL-DMO) multistring that specifies one or more Subscriber names.

  • szSubscriberDBs
    SQL-DMO multistring that specifies one or more subscription database names.

  • ValidationOption
    Long integer that specifies the type of validation performed as described in Settings.

  • ValidationMethod
    Long integer that specifies the method of validation performed as described in Settings.

  • fShutDownAgent
    Boolean that specifies whether the distribution agent immediately shuts down after successful completion of the validation process.

Prototype (C/C++)

HRESULT ValidateSubscriptions(
SQLDMO_LPCSTR szSuscriberNames,
SQLDMO_LPCSTR szSubscriberDBs,
SQLDMO_VALIDATIONOPTION_TYPE ValidationOption,
SQLDMO_VALIDATIONMETHOD_TYPE ValidationMethod,
BOOL fShutDownAgent);

Settings

Set the ValidationOption parameter using these SQLDMO_VALIDATIONOPTION_TYPE values.

Constant

Value

Description

SQLDMOValidationOption_/70Checksum

0

Perform a SQL Server 7.0 compatible Transact-SQL CHECKSUM operation.

SQLDMOValidationOption_/RowCountOnly

1

(Default). Perform a Transact-SQL @@ROWCOUNT operation.

SQLDMOValidationOption_/75Checksum

2

Perform a SQL Server 2000 compatible Transact-SQL CHECKSUM operation.

Set the ValidationMethod parameter using these SQLDMO_VALIDATIONMETHOD_TYPE values.

Constant

Value

Description

SQLDMOValidationMethod_/ConditionalFast

2

Default. Performs conditional validation first using SQLDMOValidationMethod_FastCount but reverts to using SQLDMOValidationMethod_FullCount if SQLDMOValidationMethod_FastCount indicates differences.

SQLDMOValidationMethod_/FastCount

1

Performs high speed validation, using the rowcnt column of sysindexes.

SQLDMOValidationMethod_/FullCount

0

Validates by returning the number of rows, including NULL values, and duplicates using Transact-SQL COUNT(*).

주의

szSuscriberNames and szSubscriberDBs are SQL-DMO multistring parameters. The number of names in the szSuscriberNames and szSubscriberDBs parameters must be identical. For more information about setting multistring parameters, see Using SQL-DMO Multistrings.

The result of the validation operation is written to the agent history, which can be viewed using Replication Monitor.

By default, the fShutDownAgent parameter is set to FALSE.

[!참고]

If an application calls ValidateSubscriptionson 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:

TransPublication2 Object