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

// Protocole IMAP
MaSession is emailIMAPSession
...
// Création d'un dossier dans le dossier en cours 
EmailAddFolder(MaSession, EmailCurrentFolder(MaSession) + "\Travail")

// Création d'un dossier dans le dossier personnel
EmailAddFolder(MaSession, "Dossiers personnels\Boîte de réception\TravailPerso")

// 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