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.
.gif "ms143139.note(ja-jp,SQL.90).gif") メモ : |
|---|
| 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:
|
参照
関連項目
ValidatePublication Method (TransPublication2)