Share via


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

Applies To: