TransferPercentComplete Event (SQL-DMO)

The TransferPercentComplete event occurs after SQL-DMO completes schema or data copy for a Microsoft® SQL Server™ component referenced by the Transfer object.

Applies To

Transfer Object

Syntax

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

Part Description
object Expression that evaluates to an object in the Applies To list.
Message String containing 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.

Remarks

When using the Transfer method of the Database object, SQL-DMO calculates percentage completion after a component is copied. Component copy can be implemented by simple, time-unintensive tasks such as creation of schema, or can require time-intensive tasks such as the copy of a large amount of data.

The TransferPercentComplete event is raised once for every component referenced by the Transfer object. SQL-DMO attempts to weight the value provided in the Percent argument of the event handler to reflect the time needed to re-create a component on the target database.

Prototype (C/C++)

HRESULT TransferPercentComplete(SQLDMO_LPCSTR szMessage,
long Percent);


(c) 1988-98 Microsoft Corporation. All Rights Reserved.