CancelAlter Method

Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

The CancelAlter method marks the end of a unit of change for the object referenced and discards any changes made to object property values.

Sintassi

object
.CancelAlter( )

Parts

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

Prototype (C/C++)

HRESULT CancelAlter();

Osservazioni

Outside of a BeginAlter/DoAlter block, each change to a SQL Distributed Management Objects (SQL-DMO) object causes a discrete update to the referenced Microsoft SQL Server 2000 component. Group multiple changes by calling the BeginAlter method.

All changes made after the BeginAlter method call are submitted to SQL Server the next time DoAlter is called. Changes are discarded if the CancelAlter method is called.

Nota

Calling CancelAlter restores the SQL-DMO object referenced to its state at the time of the BeginAlter call. It does not refresh the object with current values from an instance of SQL Server.

Applies to:

Alert Object	MergePublication Object
AlertSystem Object	MergePullSubscription Object
Category Object	MergeSubscription Object
DistributionArticle Object	MergeSubsetFilter Object
DistributionDatabase Object	Operator Object
DistributionPublication Object	RegisteredSubscriber Object
DistributionPublisher Object	Schedule Object
DistributionSubscription Object	Table Object
Job Object	TargetServerGroup Object
JobSchedule Object	TransArticle Object
JobServer Object	TransPublication Object
JobStep Object	TransPullSubscription Object
MergeArticle Object	TransSubscription Object
MergeDynamicSnapshotJob Object