Share this page

# 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:

- Either profilename or profilepass is not specified.

- Both profilename and profilepass are not specified.

- No profile exists on the mail client for the profilename and profilepass combination.

## 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.

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: