SMIME_read_PKCS73ssl
Parse s/mime message
Usage
#include <openssl/pkcs7.h>PKCS7 *SMIME_read_PKCS7_ex(BIO *bio, BIO **bcont, PKCS7 **p7);PKCS7 *SMIME_read_PKCS7(BIO *in, BIO **bcont);
Overview
SMIME_read_PKCS7() parses a message in S/MIME format.
in is a BIO to read the message from.
If cleartext signing is used then the content is saved in a memory bio which is written to *bcont, otherwise *bcont is set to NULL.
The parsed PKCS#7 structure is returned or NULL if an error occurred.
SMIME_read_PKCS7_ex() is similar to SMIME_read_PKCS7() but can optionally supply a previously created p7 PKCS#7 object. If p7 is NULL then it is identical to SMIME_read_PKCS7(). To create a p7 object use PKCS7_new_ex(3).
Notes
If *bcont is not NULL then the message is clear text signed. *bcont can then be passed to PKCS7_verify() with the PKCS7_DETACHED flag set.
Otherwise the type of the returned structure can be determined using PKCS7_type_is_enveloped(), etc.
To support future functionality if bcont is not NULL *bcont should be initialized to NULL. For example:
BIO *cont = NULL;PKCS7 *p7;p7 = SMIME_read_PKCS7(in, &cont);
Return values
SMIME_read_PKCS7_ex() and SMIME_read_PKCS7() return a valid PKCS7 structure or NULL if an error occurred. The error can be obtained from ERR_get_error(3).
Releases
12 releases since Debian 3.1 (Sarge); the text changed 11 times.