SelectMailbox Method  
 

Selects the specified mailbox for read-write access.

Syntax

object.SelectMailbox( MailboxName )

Parameters

MailboxName
A string argument which specifies the name of the mailbox to be selected.

Return Value

A value of zero is returned if the method succeeds. Otherwise, a non-zero error code is returned which indicates the cause of the failure.

Remarks

The SelectMailbox method is used to select a mailbox in read-write mode. If the client has a different mailbox currently selected, that mailbox will be closed and any messages marked for deletion will be expunged. To prevent deleted messages from being removed from the previous mailbox, use the UnselectMailbox method prior to selecting the new mailbox.

The special case-insensitive mailbox name INBOX is used for new messages. Other mailbox names may or may not be case-sensitive depending on the IMAP server's operating system and implementation.

To access a mailbox in read-only mode, use the ExamineMailbox method.

See Also

MailboxName Property, CheckMailbox Method, ExamineMailbox Method, ReselectMailbox Method