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 );
ppmapiA session identifier.
transactionA transaction name for this step in quotes. To instruct VuGen not to create a transaction for this step, use a null string, "".
profilenameThe profile's user name: "ProfileName=user name"
profilepassA 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 );