SQL-DMO

CancelAlter Method

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

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  

Syntax

object.CancelAlter( )

Parts

object

Expression that evaluates to an object in the Applies To list

Prototype (C/C++)

HRESULT CancelAlter();

Remarks

Outside of a BeginAlter/DoAlter block, each change to a 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.

Note  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.