C Requires Chilkat v11.0.0+
C
Preview POP3 messages and download a complete email
See more Email Object Examples
Read a short preview for each of up to five messages into an EmailBundle, print their subjects, and download the complete first entry into a separate Email. Configure a POP3 account that supports UIDL and TOP. All messages stay on the server.
Chilkat C Downloads
#include <C_CkMailMan.h>
#include <C_CkEmailBundle.h>
#include <C_CkEmail.h>
void ChilkatSample(void)
{
BOOL success;
HCkMailMan mail;
HCkEmailBundle previews;
HCkEmail header;
int i;
HCkEmail email;
success = FALSE;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
mail = CkMailMan_Create();
CkMailMan_putMailHost(mail,"pop.example.com");
CkMailMan_putMailPort(mail,995);
CkMailMan_putPopSsl(mail,TRUE);
CkMailMan_putRequireSslCertVerify(mail,TRUE);
CkMailMan_putPopUsername(mail,"MAIL_USER");
CkMailMan_putPopPassword(mail,"MAIL_PASSWORD");
previews = CkEmailBundle_Create();
// Keep the messages and request minimal previews. Range indexes are zero-based and inclusive.
success = CkMailMan_FetchRange(mail,TRUE,TRUE,0,0,4,previews);
if (success != TRUE) {
printf("%s\n",CkMailMan_lastErrorText(mail));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
return;
}
if (CkEmailBundle_getMessageCount(previews) == 0) {
printf("There are no messages to preview.\n");
success = CkMailMan_Pop3EndSession(mail);
if (success != TRUE) {
printf("%s\n",CkMailMan_lastErrorText(mail));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
return;
}
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
return;
}
header = CkEmail_Create();
i = 0;
while ((i < CkEmailBundle_getMessageCount(previews))) {
success = CkEmailBundle_EmailAt(previews,i,header);
if (success != TRUE) {
printf("%s\n",CkEmailBundle_lastErrorText(previews));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
return;
}
printf("%s %s\n",CkEmail_uidl(header),CkEmail_subject(header));
i = i + 1;
}
// A UI could use its selected row here. FetchFull uses the preview's POP3 identity.
success = CkEmailBundle_EmailAt(previews,0,header);
if (success != TRUE) {
printf("%s\n",CkEmailBundle_lastErrorText(previews));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
return;
}
email = CkEmail_Create();
success = CkMailMan_FetchFull(mail,header,email);
if (success != TRUE) {
printf("%s\n",CkMailMan_lastErrorText(mail));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
CkEmail_Dispose(email);
return;
}
success = CkMailMan_Pop3EndSession(mail);
if (success != TRUE) {
printf("%s\n",CkMailMan_lastErrorText(mail));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
CkEmail_Dispose(email);
return;
}
printf("Full message: %s Files: %d\n",CkEmail_subject(email),CkEmail_getNumAttachments(email));
success = CkEmail_SaveEml(email,"pop-received.eml");
if (success != TRUE) {
printf("%s\n",CkEmail_lastErrorText(email));
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
CkEmail_Dispose(email);
return;
}
printf("Saved pop-received.eml.\n");
CkMailMan_Dispose(mail);
CkEmailBundle_Dispose(previews);
CkEmail_Dispose(header);
CkEmail_Dispose(email);
}