共用方式為

  • 發行項

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