Rust

Open an IMAP Mailbox Read-Only

Demonstrates the Chilkat Imap.ExamineMailbox method, which opens a mailbox as read-only. Use it instead of SelectMailbox when the application must not change message state, such as the \Seen flag. This example examines the Inbox.

Background: Reading a message can have a side effect: fetching its body normally sets the \Seen flag, marking it as read. ExamineMailbox corresponds to IMAP's EXAMINE command, which opens the mailbox in a read-only mode where no such changes are made — ideal for scanning, indexing, or backup tools that must leave the user's mailbox exactly as they left it.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


// Demonstrates the Imap.ExamineMailbox method, which opens a mailbox as read-only.  Use this
// instead of SelectMailbox when the application must not change message state (such as the
// \Seen flag).

let imap = chilkat::Imap::new();

imap.set_ssl(true);
imap.set_port(993);

if imap.connect("imap.example.com").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

if imap.login("user@example.com", "myPassword").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

// Open the Inbox as read-only.
if imap.examine_mailbox("Inbox").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

println!("Inbox opened read-only.");

if imap.disconnect().is_err() {
    println!("{}", imap.last_error_text());
    return;
}