Progress Event

Fires to indicate the progress of long-running vault operations.

Syntax

• C#
• VB.NET

public event OnProgressHandler OnProgress;

public delegate void OnProgressHandler(object sender, CbdriveProgressEventArgs e);

public class CbdriveProgressEventArgs : EventArgs {
  public int Operation { get; }
  public int Progress { get; }
  public int Total { get; }
  public bool CanStop { get; }
  public bool Stop { get; set; }
}

Public Event OnProgress As OnProgressHandler

Public Delegate Sub OnProgressHandler(sender As Object, e As CbdriveProgressEventArgs)

Public Class CbdriveProgressEventArgs Inherits EventArgs
  Public ReadOnly Property Operation As Integer
  Public ReadOnly Property Progress As Integer
  Public ReadOnly Property Total As Integer
  Public ReadOnly Property CanStop As Boolean
  Public Property Stop As Boolean
End Class

Remarks

This event fires anytime the component needs to report the progress of a long-running vault operation. Certain operations may cause this event to fire repeatedly.

The Operation parameter specifies which long-running operation caused this event to fire. Possible values are:

The Progress and Total parameters reflect the current and maximum progress values. Both will be 0 if the operation's progression cannot be determined.

The CanStop parameter indicates whether the application may interrupt the operation by setting the Stop parameter to true. Note that some operations can only be interrupted at certain points over the course of their lifetime.

Note: An application should not attempt to call component's methods from handlers of this event. Doing this is guaranteed to cause a deadlock.

Note: when a storage is opened concurrently in read-only mode by several applications using CBDrive or CBMemDrive component, the event will fire only in the first application. To prevent such a situation, always open a vault in read-write mode.