![]() |
Chilkat HOME Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi DLL Go Java Node.js Objective-C PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Unicode C) POP3 Read S/MIME Encrypted EmailRead S/MIME encrypted email. Note: This example requires Chilkat v11.0.0 or greater.
#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.someMailServer.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); } |
© 2000-2025 Chilkat Software, Inc. All Rights Reserved.