PasswordNeeded Event

Requests a password from the application.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FirePasswordNeeded(DCAuthPasswordNeededEventParams *e);

typedef struct {
  const char *NeededFor;
  const char *Id;
  char *Password;
  int Cancel;
  int reserved;
} DCAuthPasswordNeededEventParams;

Unicode (Windows)
virtual INT FirePasswordNeeded(DCAuthPasswordNeededEventParams *e);

typedef struct {
  LPCWSTR NeededFor;
  LPCWSTR Id;
  LPWSTR Password;
  BOOL Cancel;
  INT reserved;
} DCAuthPasswordNeededEventParams;

- (void)onPasswordNeeded:(NSString*)neededFor :(NSString*)id :(NSString**)password :(int*)cancel;

#define EID_DCAUTH_PASSWORDNEEDED 7

virtual INT SECUREBLACKBOX_CALL FirePasswordNeeded(LPSTR &lpszNeededFor, LPSTR &lpszId, LPSTR &lpszPassword, BOOL &bCancel);

Remarks

Subscribe to this event to pass a password to the server component. The NeededFor parameter specifies the entity a password for which is being requested (which is typically a certificate). The Id parameter provides the entity's identifier, such as a path to the certificate being loaded. When handling this event, assign the Password to the valid password if you have it; otherwise, set Cancel to true to abort the operation.