Help / WLanguage / WLanguage functions / Communication / Managing emails
  • Creating a profile
  • Current directory
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Allows you to access data handled by the Outlook messaging software (emails, contacts, groups of contacts, tasks, appointments and folders). This function is equivalent to EmailStartOutlookSession. To close the session, you must use CloseSession or EmailCloseSession.
Caution: This function cannot be used to access the data handled by the Outlook Express messaging software.
Remark: When using OutlookStartSession, the current directory is automatically modified by Outlook.
// Start the session
IF OutlookStartSession("MyProfile") <> 0 THEN
Info("Session started")
<Result> = OutlookStartSession(<Profile> [, <Start options>])
<Result>: Integer
  • Session identifier.
  • 0 or False if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
<Profile>: Character string
Identifies the connection profile.
If this parameter corresponds to an empty string (""):
  • if several profiles are defined on the current computer, OutlookStartSession displays a window containing all profiles among which the user can choose his own profile.
  • if a single profile is defined on the current computer, OutlookStartSession automatically selects this profile.
<Start options>: Optional integer constant
Mode for starting the Outlook session:
(Default value)
The AppointmentXXX functions will list the contacts associated with the appointments in the mAppointment.Participant variable (see Appointment structure).
outlookAPTWithParticipantThe AppointmentXXX functions will list the participants associated with the appointments in the following variables:
  • mAppointment.Participant
  • mAppointment.ParticipantCc
  • mAppointment.ParticipantBcc
For more details, see Appointment structure.

Creating a profile

To start a new session with Outlook, a "profile" must be defined. This "profile" is defined in the configuration of the Internet connection with Outlook.
To create a profile:
  1. Start Outlook.
  2. In the "Choosing a profile" window, click [New].
  3. Select the "Microsoft Exchange Server" service.
  4. Give a name to the profile.
  5. Enter the name of Microsoft Exchange server.

Current directory

Caution: OutlookStartSession modifies the path of the current directory (returned by fCurrentDir).
Component: wd300com.dll
Minimum version required
  • Version 11
This page is also available for…
Click [Add] to post a comment

Last update: 07/03/2023

Send a report | Local help