Jaa


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.

Applies To:

Transfer Object