![]() |
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
(C++) Download and Save Email Attachments (POP3)See more POP3 ExamplesDownloads emails from a POP3 mailbox and saves all attachments.Note: This example requires Chilkat v11.0.0 or greater.
#include <CkMailMan.h> #include <CkEmailBundle.h> #include <CkEmail.h> void ChilkatSample(void) { bool 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. CkMailMan mailman; // Set the POP3 server's hostname mailman.put_MailHost("pop.yourserver.com"); // Set the POP3 login/password. mailman.put_PopUsername("***"); mailman.put_PopPassword("***"); // Copy the all email from the user's POP3 mailbox // into a bundle object. The email remains on the server. // FetchAll is a reasonable choice for POP3 maildrops that don't have too many // emails. For larger mail drops, one might download emails one at a time.. CkEmailBundle bundle; bool keepOnServer = true; bool headersOnly = false; // Irrelevent because we are NOT downloading headers-only int numBodyLines = 0; success = mailman.FetchAll(keepOnServer,headersOnly,numBodyLines,bundle); if (success == false) { std::cout << mailman.lastErrorText() << "\r\n"; return; } // The directory path can be relative or absolute. // This shows a Windows style directory path. On other operating systems, the path // would be different.. const char *dirPath = "c:/myAttachments"; CkEmail email; int bundleIndex = 0; int numMessages = bundle.get_MessageCount(); while ((bundleIndex < numMessages)) { bundle.EmailAt(bundleIndex,email); // Save all attachments to the specified directory. // The directory is automatically created if it does not yet exist. success = email.SaveAllAttachments(dirPath); if (success == false) { std::cout << email.lastErrorText() << "\r\n"; return; } // The OverwriteExisting property controls whether already-existing files // are automatically overwritten. By default, it is set to true so that existing // files will be overwritten. // Setting OverwriteExisting = false will cause the attachment-saving methods to generate // unique filenames if a file with the same name already exists. The actual filename(s) // saved will be present by calling GetAttachmentFilename for each attachment *after* // saving. // For example... email.put_OverwriteExisting(false); success = email.SaveAllAttachments(dirPath); if (success == false) { std::cout << email.lastErrorText() << "\r\n"; return; } int numAttachments = email.get_NumAttachments(); int attachIndex = 0; while ((attachIndex < numAttachments)) { // If the attachment filename was changed to prevent overwriting, // GetAttachmentFilename will return the new filename. std::cout << email.getAttachmentFilename(attachIndex) << "\r\n"; attachIndex = attachIndex + 1; } // Attachments can also be saved individually. attachIndex = 0; while ((attachIndex < numAttachments)) { std::cout << "Original Filename: " << email.getAttachmentFilename(attachIndex) << "\r\n"; success = email.SaveAttachedFile(attachIndex,dirPath); if (success == false) { std::cout << email.lastErrorText() << "\r\n"; return; } // If OverwriteExisting = true, the saved filename will always equal the original filename, // unless there are characters present in the filename that are not allowed by Windows, // such as * ? < > | etc. In those cases the illegal characters are either removed or replaced // with underscore characters to allow the file to be saved. std::cout << "Saved Filename: " << email.getAttachmentFilename(attachIndex) << "\r\n"; attachIndex = attachIndex + 1; } bundleIndex = bundleIndex + 1; } } |
© 2000-2025 Chilkat Software, Inc. All Rights Reserved.