mapi_logon

Example: mapi_logonMS Exchange Server Functions (MAPI)

Logs on to MS Exchange.

int mapi_logon( char *transaction, char *profilename, char *profilepass, LAST );
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 in quotes. Optional.
profilepassA 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.