BeginAlter Method (SQL-DMO)

The BeginAlter method marks the start of a unit of change for the object referenced.

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

Syntax

object.BeginAlter()

Part	Description
object	Expression that evaluates to an object in the Applies To list

Remarks

Outside of a BeginAlter/DoAlter block, each change to a SQL-DMO object property causes a discrete update to the referenced Microsoft® SQL Server™ component. Group multiple changes by calling the BeginAlter method.

All changes made after the BeginAlter method are submitted to SQL Server the next time the DoAlter method is called on the object.

Prototype (C/C++)

HRESULT BeginAlter();