OutlookStartSession (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / Managing emails

Creating a profile
Current directory

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

OutlookStartSession (Function)

In french: OutlookOuvreSession

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.

Example

See additional examples

// Start the session
IF OutlookStartSession("MyProfile") <> 0 THEN
Info("Session started")
ELSE
Error(ErrorInfo())
END

Syntax

<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.
The default profile is returned by OutlookDefaultProfile.
The list of available profiles is returned by OutlookListProfile.
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:
outlookAPTWithContact
(Default value) The AppointmentXXX functions will list the contacts associated with the appointments in the mAppointment.Participant variable (see Appointment structure).
outlookAPTWithParticipant The 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.

Remarks

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:

Start Outlook.
In the "Choosing a profile" window, click [New].
Select the "Microsoft Exchange Server" service.
Give a name to the profile.
Enter the name of Microsoft Exchange server.

Current directory

Caution: OutlookStartSession modifies the path of the current directory (returned by fCurrentDir).

Component: wd300com.dll