PercentCompleteAtStep Event

SQL-DMO

SQL-DMO

PercentCompleteAtStep Event

The PercentCompleteAtStep event occurs when a database schema and/or data copy operation reaches a system-defined midpoint in processing.

Applies To
Transfer Object
Syntax

Private Sub object_PercentCompleteAtStep( Message as String ,
Percent as Long )

Parts

object

Expression that evaluates to an object in the Applies To list

Message

String that contains descriptive message text

Percent

Long integer representation of a percentage value. The value is the percent of processing complete scaled by 100. For example, a process seven percent complete reports the value 7.

Prototype (C/C++)

HRESULT PercentCompleteAtStep(SQLDMO_LPCSTR szMessage,
long Percent);

Remarks

When using the Transfer and ScriptTransfer methods of the Database object, SQL-DMO breaks up processing into system-defined units. As each unit completes, SQL-DMO determines the percentage of the operation completed, and raises the PercentCompleteAtStep event.