ValidateSubscriptions Method
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.
The ValidateSubscriptions method invokes inline validation for one or more specified subscriptions.
Sintaxis
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(*). |
Notas
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.
[!NOTA] If an application calls ValidateSubscriptions 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:
|
Vea también
Referencia
ValidatePublication Method (TransPublication2)