IPWorks Encrypt 2020 C++ Edition

Questions / Feedback?

SignerCertInfo Event

Fired during verification of the signed message.

Syntax

ANSI (Cross Platform)
virtual int FireSignerCertInfo(SMIMESignerCertInfoEventParams *e);
typedef struct {
const char *Issuer;
const char *SerialNumber;
const char *SubjectKeyIdentifier;
const char *CertEncoded; int lenCertEncoded; int reserved; } SMIMESignerCertInfoEventParams; Unicode (Windows) virtual INT FireSignerCertInfo(SMIMESignerCertInfoEventParams *e);
typedef struct {
LPCWSTR Issuer;
LPCWSTR SerialNumber;
LPCWSTR SubjectKeyIdentifier;
LPCSTR CertEncoded; INT lenCertEncoded; INT reserved; } SMIMESignerCertInfoEventParams;
- (void)onSignerCertInfo:(NSString*)issuer :(NSString*)serialNumber :(NSString*)subjectKeyIdentifier :(NSData*)certEncoded;
#define EID_SMIME_SIGNERCERTINFO 3

virtual INT IPWORKSENCRYPT_CALL FireSignerCertInfo(LPSTR &lpszIssuer, LPSTR &lpszSerialNumber, LPSTR &lpszSubjectKeyIdentifier, LPSTR &lpCertEncoded, INT &lenCertEncoded);

Remarks

During verification, this event will be raised while parsing the signer's certificate information. The parameters which are populated depends on the options used when the message was originally signed. This information may be used to select the correct certificate for SignerCert in order to verify the signature. The following parameters may be populated.

Issuer specifies the subject of the issuer of the certificate used to sign the message.

SerialNumber is the serial number of the certificate used to sign the message.

SubjectKeyIdentifier is the X.509 subjectKeyIdentifier extension value of the certificate used to sign the message encoded as a hex string.

CertEncoded is the PEM (base64 encoded) public certificate needed to verify the signature. Note: when this value is present the class will automatically use this value to perform signature verification.

The SignerCert property may be set from within this event. In this manner the decision of which signer certificate to load may be delayed until the parameters of this event are inspected and the correct certificate can be located and loaded.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Encrypt 2020 C++ Edition - Version 20.0 [Build 8155]