MS Exchange Server Functions (MAPI) > Alphabetical List of Functions > mapi_logon

mapi_logon

Example: mapi_logon MS Exchange Server Functions (MAPI)

Logs on to MS Exchange.

int mapi_logon( char *transaction, char *profilename, char *profilepass, LAST );
transaction A transaction name for this step in quotes. To instruct VuGen not to create a transaction for this step, use a null string, "".
profilename The profile's user name in quotes. Optional.
profilepass A profile's password in quotes. Optional.
LAST A marker indicating the end of the argument list.

The mapi_logon function logs on to an MS Exchange server using simple MAPI, the MS Exchange protocol.

This function is for use with global sessions. For multiple sessions, use the mapi_logon_ex function, which allows you to specify a session identifier.

The function logs on to the MS Exchange Server using the default account's user name and password, and no error is issued, under the following circumstances:

Return Values

If this function succeeds, it returns LR_PASS. Otherwise, it returns LR_FAIL.

Parameterization

All arguments of this function of the type char, can be parameterized with standard parameterization.