KeyNeeded Event

This event is fired to request a vault encryption/decryption key from the application.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FireKeyNeeded(PasswordVaultKeyNeededEventParams *e);

typedef struct {
  int Cancel;
  int reserved;
} PasswordVaultKeyNeededEventParams;

Unicode (Windows)
virtual INT FireKeyNeeded(PasswordVaultKeyNeededEventParams *e);

typedef struct {
  BOOL Cancel;
  INT reserved;
} PasswordVaultKeyNeededEventParams;

- (void)onKeyNeeded:(int*)cancel;

#define EID_PASSWORDVAULT_KEYNEEDED 3

virtual INT SECUREBLACKBOXLITE_CALL FireKeyNeeded(BOOL &bCancel);

Remarks

Class fires this event to request a vault encryption key from the application. Note that this is not the same as entry encryption key, which is requested by EntryKeyNeeded. The key requested by this event is used to encrypt or decrypt the whole vault.

The handler of this event should assign the password or key to be used to Password or Key property respectively. Set Cancel to true to abort the operation.