EmailChangeFolder (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

EmailReadMessageHeader

EmailReadNext

EmailReadNextHeader

EmailReadPrevious

EmailReadPreviousHeader

EmailStartIMAPSession

EmailStartNotesSession

EmailStartOutlookSession

EmailStartPOP3Session

EmailStartSMTPSession

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

EmailChangeFolder (Function)

In french: EmailChangeDossier

Modifies the current folder in the messaging software (Outlook, messaging software using the IMAP protocol, ...).

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

Caution: The "Generic folders" are not supported.

Reminder: This function cannot be used to modify the current folder in the Outlook Express messaging software.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 22 and later

This function is now available in Android Widget mode.

This function is now available for Android applications.

New in version 22

This function is now available in Android Widget mode.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available for Android applications.

Example

See additional examples

Versions 15 and later

// IMAP protocol
IF EmailStartIMAPSession(EDT_USER, EDT_PASSWORD, ...
"imap.mydomain.fr") = True THEN
EmailChangeFolder(EDT_USER, "Personal folders\Inbox\Work")
...
ELSE
Error("Unable to establish the connection")
END

New in version 15

// Start the session
SessionID = EmailStartOutlookSession("MyProfile")
...
// Change the current folder
EmailChangeFolder(SessionID, "Personal folders\Inbox\Work")

Syntax

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

<Result>: Boolean

True if the modification was performed,
False otherwise (the specified path does not exist for example). The ErrorOccurred variable is set to True if an error occurs. To find out the name of the error, use the function ErrorInfo with the constant errMessage.

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

Identifier of current email session. This identifier can be:
an integer returned by EmailStartOutlookSession or OutlookStartSession.
Versions 15 and later
an emailOutlookSession variable.
New in version 15
an emailOutlookSession variable.
an emailOutlookSession variable.
Versions 15 and later
an emailIMAPSession variable.
New in version 15
an emailIMAPSession variable.
an emailIMAPSession variable.
Versions 15 and later
the user name passed to EmailStartIMAPSession.
New in version 15
the user name passed to EmailStartIMAPSession.
the user name passed to EmailStartIMAPSession.

<Folder path>: Unicode character string (with quotes)

Path of new current folder.

Component: wd260com.dll