Unicode C
Unicode C
POP3 Read S/MIME Encrypted Email
Read S/MIME encrypted email.Chilkat Unicode C Downloads
#include <C_CkMailManW.h>
#include <C_CkEmailBundleW.h>
#include <C_CkEmailW.h>
void ChilkatSample(void)
{
BOOL success;
HCkMailManW mailman;
HCkEmailBundleW bundle;
BOOL keepOnServer;
BOOL headersOnly;
int numBodyLines;
HCkEmailW email;
int i;
success = FALSE;
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
// The mailman object is used for receiving (POP3)
// and sending (SMTP) email.
mailman = CkMailManW_Create();
// Set the POP3 server's hostname
CkMailManW_putMailHost(mailman,L"pop.example.com");
// Set the POP3 login/password.
CkMailManW_putPopUsername(mailman,L"myLogin");
CkMailManW_putPopPassword(mailman,L"myPassword");
// If running on Microsoft Windows, the Chilkat mailman
// will automatically search the registry-based certificate stores
// for matching certificates and private keys required for
// decryption. However, on Linux, MAX OS X, and other
// operating systems, no such thing exists. Therefore, you'll
// need to specify one or more PFX (.p12 / .pfx) files as
// sources for locating the certs required for decyrption.
success = CkMailManW_AddPfxSourceFile(mailman,L"/pfxFiles/certs_and_keys_1.pfx",L"pfxPassword1");
if (success == FALSE) {
wprintf(L"%s\n",CkMailManW_lastErrorText(mailman));
CkMailManW_Dispose(mailman);
return;
}
success = CkMailManW_AddPfxSourceFile(mailman,L"/pfxFiles/certs_and_keys_2.pfx",L"pfxPassword2");
if (success == FALSE) {
wprintf(L"%s\n",CkMailManW_lastErrorText(mailman));
CkMailManW_Dispose(mailman);
return;
}
// ...
// Note: On MS Windows, it is not required to provide PFX sources
// if the needed certs and private keys are already installed
// on the system (in the registry-based certificate stores).
// Copy the all email from the user's POP3 mailbox
// into a bundle object. The email remains on the server.
bundle = CkEmailBundleW_Create();
keepOnServer = TRUE;
headersOnly = FALSE;
// Irrelevent because we are NOT downloading headers-only
numBodyLines = 0;
success = CkMailManW_FetchAll(mailman,keepOnServer,headersOnly,numBodyLines,bundle);
if (success == FALSE) {
wprintf(L"%s\n",CkMailManW_lastErrorText(mailman));
CkMailManW_Dispose(mailman);
CkEmailBundleW_Dispose(bundle);
return;
}
// S/MIME security envelopes are automatically "unwrapped"
// when a message is retrieved from the server. Signed emails are automatically verified, and
// encrypted emails are automatically decrypted, restoring the email to the original state before
// signing and/or encrypting. Information about the signing and encrypting certificates can be
// retrieved from the Email object (methods: GetSignedByCert, GetEncryptedByCert;
// properties: SignedBy, EncryptedBy, SignaturesValid, Decrypted, ReceivedSigned,
// ReceivedEncrypted).
// Loop over the bundle
email = CkEmailW_Create();
i = 0;
while (i < CkEmailBundleW_getMessageCount(bundle)) {
CkEmailBundleW_EmailAt(bundle,i,email);
wprintf(L"%s\n",CkEmailW_ck_from(email));
wprintf(L"%s\n",CkEmailW_subject(email));
// At this point, if the email was signed and/or encrypted, it is already "unwrapped", i.e.
// the email is already decrypted and in a state as if it were never signed or encrypted.
// You may check to see if the email was received encrypted or signed, and if so,
// whether it was successfully unwrapped and who signed or encrypted it:
if (CkEmailW_getReceivedEncrypted(email) == TRUE) {
wprintf(L"This email was encrypted when received.\n");
if (CkEmailW_getDecrypted(email) == TRUE) {
wprintf(L"This email was successfully decrypted. It was encrypted by:\n");
wprintf(L"%s\n",CkEmailW_encryptedBy(email));
}
else {
wprintf(L"This email was not decrypted.\n");
}
}
if (CkEmailW_getReceivedSigned(email) == TRUE) {
wprintf(L"This email was signed when received.\n");
if (CkEmailW_getSignaturesValid(email) == TRUE) {
wprintf(L"The signature was verified. It was signed by:\n");
wprintf(L"%s\n",CkEmailW_signedBy(email));
}
else {
wprintf(L"The signature verification failed.\n");
}
}
// The email's body, HTML body, attachments, etc.
// are decrypted and available just like any non-encrypted email.
wprintf(L"--\n");
i = i + 1;
}
CkMailManW_Dispose(mailman);
CkEmailBundleW_Dispose(bundle);
CkEmailW_Dispose(email);
}