Xbase++

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. Xbase++

LOCAL nSuccess
LOCAL oImap
LOCAL cCaps

nSuccess := 0

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

oImap := CreateObject("Chilkat.Imap")

//  Use TLS
oImap:Ssl := 1
oImap:Port := 993
nSuccess := oImap:Connect("MY-IMAP-DOMAIN")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    RETURN
ENDIF

//  Authenticate
nSuccess := oImap:Login("MY-IMAP-LOGIN", "MY-IMAP-PASSWORD")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    RETURN
ENDIF

//  Get the list of capabilities:
cCaps := oImap:Capability()
? "Capabilities: " + cCaps

//  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 (oImap:HasCapability("QUOTA", cCaps) == 1)
    ? "IMAP server supports the QUOTA extension."
ENDIF

IF (oImap:HasCapability("IDLE", cCaps) == 1)
    ? "IMAP server supports IDLE."
ENDIF

//  Disconnect from the IMAP server.
nSuccess := oImap:Disconnect()

oImap:destroy()