RecipientFound Event

Signifies that the archive was found to be encrypted with a digital certificate.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FireRecipientFound(ArchiveWriterRecipientFoundEventParams *e);

typedef struct {
  const char *PublicKeyHash;
  int lenPublicKeyHash;
  int CertFound;
  int reserved;
} ArchiveWriterRecipientFoundEventParams;

Unicode (Windows)
virtual INT FireRecipientFound(ArchiveWriterRecipientFoundEventParams *e);

typedef struct {
  LPCSTR PublicKeyHash;
  INT lenPublicKeyHash;
  BOOL CertFound;
  INT reserved;
} ArchiveWriterRecipientFoundEventParams;

- (void)onRecipientFound:(NSData*)publicKeyHash :(BOOL)certFound;

#define EID_ARCHIVEWRITER_RECIPIENTFOUND 8

virtual INT SECUREBLACKBOX_CALL FireRecipientFound(LPSTR &lpPublicKeyHash, INT &lenPublicKeyHash, BOOL &bCertFound);

Remarks

The class fires this event to notify the application that the archive was found to be encrypted with a digital certificate. The hash of the certificate's public key is provided in the PublicKeyHash parameter.

CertFound indicates whether a certificate with a matching public key hash was found in the DecryptionCertificates list. If it wasn't, you need to locate it on the system and add it to that list: class won't be able to decrypt the archive otherwise.

Please note that the certificate must have an associated private key to be capable of decryption.