PercentCompleteAtStep Event
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The PercentCompleteAtStep event occurs when a database schema and/or data copy operation reaches a system-defined midpoint in processing.
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.