Gmail IMAP: Connect with an App Password
Authenticate to Gmail over implicit TLS on port 993, then open INBOX read-only and report its message count. No message is downloaded or changed. This replaces ordinary-password login and removes authentication-session logging.
Personal Gmail IMAP is always enabled. Workspace administrators can restrict IMAP access. For OAuth2, use Gmail IMAP token authentication.
Use an account-specific app password generated after enabling 2-Step Verification, loaded from protected configuration. A normal Google password will not work. App passwords may be unavailable under account or Workspace policy; OAuth2 is preferred. Changing the Google account password revokes app passwords. The obsolete less-secure-apps switch is not a setup option. Google app-password requirements.
See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.
Chilkat Unicode C++ Downloads
#include <CkImapW.h>
void ChilkatSample(void)
{
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
const wchar_t *mailbox = L"user@example.com";
CkImapW imap;
imap.put_Ssl(true);
imap.put_Port(993);
imap.put_RequireSslCertVerify(true);
success = imap.Connect(L"imap.gmail.com");
if (success != true) {
wprintf(L"Could not establish the Gmail IMAP TLS connection.\n");
return;
}
success = imap.Login(mailbox,L"YOUR_16_CHARACTER_APP_PASSWORD");
if (success != true) {
imap.Disconnect();
wprintf(L"IMAP authentication failed. Check the app password, mailbox, and account policy.\n");
return;
}
// EXAMINE is read-only; no message is downloaded, marked read, moved, or deleted.
success = imap.ExamineMailbox(L"INBOX");
if (success != true) {
imap.Logout();
imap.Disconnect();
wprintf(L"Could not examine INBOX.\n");
return;
}
wprintf(L"Messages in INBOX: %d\n",imap.get_NumMessages());
success = imap.Logout();
imap.Disconnect();
if (success != true) {
wprintf(L"The read-only operation completed, but IMAP logout failed.\n");
}
}