(MFC) IMAP Capability

Demonstrates how to send the CAPABILITY command to request a listing of capabilities that the IMAP server supports. A capability name which begins with "AUTH=" indicates that the server supports that particular authentication mechanism.

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkImap.h>

void ChilkatSample(void)
    {
    CkString strOut;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkImap imap;

    // Use TLS
    imap.put_Ssl(true);
    imap.put_Port(993);
    bool success = imap.Connect("MY-IMAP-DOMAIN");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // Authenticate
    success = imap.Login("MY-IMAP-LOGIN","MY-IMAP-PASSWORD");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    // Get the list of capabilities:
    const char *caps = imap.capability();
    strOut.append("Capabilities: ");
    strOut.append(caps);
    strOut.append("\r\n");

    // Here is an example of the string returned:
    // * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN X-GM-EXT-1 
    // UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT APPENDLIMIT=35882577
    // LIST-EXTENDED LIST-STATUS

    // Chilkat v9.5.0.58 introduces the HasCapability method to
    // check to see if a particular capability exists:
    if (imap.HasCapability("QUOTA",caps) == true) {
        strOut.append("IMAP server supports the QUOTA extension.");
        strOut.append("\r\n");
    }

    if (imap.HasCapability("IDLE",caps) == true) {
        strOut.append("IMAP server supports IDLE.");
        strOut.append("\r\n");
    }

    // Disconnect from the IMAP server.
    success = imap.Disconnect();


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }