Share this page

# mapi_logon_ex

MS Exchange Server Functions (mapi)

Logs on to a specific MS Exchange session.

    int mapi_logon_ex( MAPI *ppmapi, char *transaction, char *profilename, char *profilepass, NULL );

ppmapi | A session identifier.
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: `"ProfileName=`user name`"`
profilepass | A profile's password: `"ProfilePass=`password`",`
LAST | A marker indicating the end of the argument list.

The mapi_logon_ex function logs on to a MS Exchange server for a specific session. It performs a logon using Simple MAPI, the MS Exchange protocol.

This function is for use with multiple sessions. For global sessions, use the mapi_logon function, which leaves out the session identifier.

Note: Make sure that Remember credentials is selected for the mail profile, to avoid failure during replay.

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

## Example

In the following example, the mapi_logon_ex function logs on to the MAPI server.

    mapi_logon_ex(&mapi,"Logon",
                "ProfileName=John Smith",
                "ProfilePass=Tiger",
                LAST );

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