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

A number of 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.