Catalyst Internet Mail .NET

InternetMail.CreateMailbox Method 

Creates a new mailbox on the server.

[Visual Basic]
Public Function CreateMailbox( _
   ByVal mailboxName As String _
) As Boolean
[C#]
public bool CreateMailbox(
   string mailboxName
);

Parameters

mailboxName
A string which specifies the name of the new mailbox to be created.

Return Value

This method returns a boolean value. If the method succeeds, the return value is true. If the method fails, the return value is false. To get extended error information, check the value of the LastError property.

Remarks

The CreateMailbox method creates a new mailbox on the server. If the mailbox name is suffixed with the server's hierarchy delimiter, this indicates to the server that the client intends to create mailbox names under the specified name in the hierarchy. If superior hierarchical names are specified in the mailbox name, then the server may automatically create them as needed. For example, if the mailbox name "Mail/Office/Projects" is specified and "Mail/Office" does not exist, it may be automatically created by the server.

The special mailbox name INBOX is reserved, and cannot be created. It is recommended that mailbox names only consist of printable ASCII characters, and the special characters "*" and "%" should be avoided.

See Also

InternetMail Class | SocketTools Namespace