EmailAddFolder (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / Managing emails

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EmailAddFolder (Function)

In french: EmailAjouteDossier

Adds a folder into the messaging software (Outlook, messaging software using the IMAP protocol (Internet Message Access Protocol), ...).

This folder is created in the "Personal folders" branch.

Reminder: This function cannot be used to add a folder in Outlook Express.

Example

// IMAP protocol
MySession is emailIMAPSession
...
// Create a folder in the current folder
EmailAddFolder(MySession, EmailCurrentFolder(MySession) + "\Work")

// Create a folder in the custom folder
EmailAddFolder(MySession, "Personal folders\Inbox\MyOwnWork")

// Start the Outlook session
SessionID = EmailStartOutlookSession("MyProfile")
...
// Create a folder in the current folder
EmailAddFolder(SessionID, EmailCurrentFolder(SessionID) + "\Work")

// Create a folder in the custom folder
EmailAddFolder(SessionID, "Personal folders\Inbox\MyOwnWork")

Syntax

<Result> = EmailAddFolder(<Session> , <Folder path>)

<Result>: Boolean

True if the addition was performed,
False otherwise. If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo with the errMessage constant.

<Session>: Character string, integer, or emailOutlookSession or emailIMAPSession variable

Identifier of the current email session. This identifier can be:
an integer returned by EmailStartOutlookSession or OutlookStartSession.
a variable of type emailOutlookSession.
a variable of type emailIMAPSession.
the username passed to EmailStartIMAPSession.

<Folder path>: Unicode string

Path of folder to create. This path must necessarily start with "Personal folders".
If this path contains several branches that do not exist, all the branches are created.

Component: wd300com.dll