Selects the specified mailbox for read-only access.
Syntax
object.ExamineMailbox( MailboxName )
Remarks
The ExamineMailbox method is used to select a mailbox in
read-only mode. Messages can be read, but they cannot be modified
or deleted from the mailbox and new messages will not lose their
status as new messages if they are accessed.
- MailboxName
- A string argument which specifies the name of the mailbox to be
examined.
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
examining 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-write mode, use the
SelectMailbox method.
Return Value
A value of zero is returned if the method was successful.
Otherwise, a non-zero error code is returned which indicates the
cause of the failure.
See Also
MailboxName Property,
CheckMailbox Method, ReselectMailbox Method, SelectMailbox Method
|