SetGlobalListener method

Specifies the listener objects used to process global synchronization and SQL pass-through messages.

Syntax

Visual Basic
Public Sub SetGlobalListener( _
   ByVal syncListener As ULSyncProgressListener, _
   ByVal sqlListener As ULSqlPassthroughProgressListener _
)

C#
public void SetGlobalListener(
   ULSyncProgressListener syncListener,
   ULSqlPassthroughProgressListener sqlListener
);

Parameters

syncListener The ULSyncProgressListener object that implements SyncProgressed(), which is called for global synchronization messages.
sqlListener The ULSqlPassthroughProgressListener object that implements ScriptProgressed(), which is called as each SQL pass-through script is executed.

Remarks

When the SYNCHRONIZE profileName SQL statement is executed, its progress messages are routed to syncListener, if not null (Nothing in Visual Basic).

Several SQL scripts may be available and automatically executed when a database is connected. Also, scripts may be passed down in a subsequent synchronization, and executed directly with ULConnection.ExecuteSQLPassthroughScripts(). In either case, script progress messages will be routed to sqlListener, if not null (Nothing in Visual Basic).

To remove either listener pass a null reference in a call to SetGlobalListener. As of 11.0, applications no longer need to remove listeners before exiting.