MAPILogonEx

4/8/2010

The MAPILogonEx function logs a client application onto a MAPI session with the Windows Mobile messaging subsystem.

Syntax

HRESULT MAPILogonEx(
  ULONG ulUIParam, 
  LPTSTR lpszProfileName, 
  LPTSTR lpszPassword, 
  FLAGS flFlags, 
  LPMAPISESSION FAR* lppSession 
);

Parameters

  • ulUIParam
    [in] Ignored.
  • lpszProfileName
    [in] Ignored.
  • lpszPassword
    [in] Ignored.
  • flFlags
    [in] Ignored.
  • lppSession
    [out] Reference to the Windows Mobile MAPI session interface, ICEMAPISession. Cast this parameter as a reference to IMAPISession.

Return Value

This function returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The logon succeeded.
  • MAPI_E_NOT_ENOUGH_MEMORY
    Not enough memory to create a MAPI session.

Requirements

Header mapix.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPISession::GetMsgStoresTable
IMAPISession::OpenMsgStore
MAPI Functions
MAPIInitialize

Other Resources

Messaging