OriginalName Property
Gets the original mailbox name as it's provided
by the IMAP server (not decoded from UTF-7M). This property always contains
original mailbox name and doesn't matter if UTF7EncodeMailboxNames
is set to False or True.
It's recommended to set UTF7EncodeMailboxNames property to
False and use this property value as a mailbox name when passing
it to a method (like SelectMailbox,
ExamineMailbox,
AppendMessage
or any other which accepts the mailbox name as a parameter). This will allow
you to avoid various issues if your IMAP server doesn't support UTF-7M encoding
for mailbox names.
At the same time, use Name
property to display human-readable name of the mailbox. In other words, IMAP
servers understand OriginalName while human users understand
Name. This is valid if UTF7EncodeMailboxNames
is False.
Value Type: | String | |
Parameters: | None | |
Remarks: | This property is read-only |
Usage example:
' This sample retrieves and displays the name of Inbox as-is. ' This doesn't make a lot of sense because "Inbox" name is in Latin and will return Inbox ' but for non-English names it will be different than Name property value. Dim Mailer, Stats 'Using visual basic to create object Set Mailer = CreateObject("MailBee.IMAP4") 'Using ASP to create object 'Set Mailer = Server.CreateObject("MailBee.IMAP4") 'In ASP use Response.Write instead of MsgBox Mailer.EnableLogging = True Mailer.LogFilePath = "C:\Temp\imap4_log.txt" Mailer.ClearLog Mailer.LicenseKey = "put your license key here" If Mailer.Connect("mail.server.com", 143, "MyName", "MyPassword") Then Set Stats = Mailer.GetMailboxStatus("Inbox") If Not Stats Is Nothing Then MsgBox "OriginalName=" & Stats.OriginalName End If Mailer.Disconnect End If
See Also:
Name Property
UTF7EncodeMailboxNames Property
Copyright © 2002-2024, AfterLogic Corporation. All rights reserved.