• Question

  • I have a quick question. I am trying to debug an application which utilizes the MapiLogonEx parameter to access MAPI. The code I am looking at provides the value 1022h as a parameter (FLFLAG) to the MapiLogonEx function. Microsoft documentation specifies this flag can be changed to represent the values shown below. Does anyone know which one of the below values would be represented by the value 1022h (4130 decimal)? I am unable to find documentation which answers this question. Also, is there documentation avaiable which documents the lppSession (MAPI session interface), i.e. various functions avaiable within this structure after a call to MAPILOGONEX? 

    Thanks in advance for any assistance!


    [in] Bitmask of flags used to control how logon is performed. The following flags can be set:


    The shared session should be returned, allowing subsequent clients to acquire the session without providing any user credentials.


    The default profile should not be used, and the user should be required to supply a profile.


    Log on with extended capabilities. This flag should always be set.


    An attempt should be made to download all of the user's messages before returning. If the MAPI_FORCE_DOWNLOAD flag is not set, messages can be downloaded in the background after the call to MAPILogonEx returns.


    A dialog box should be displayed to prompt the user for logon information if required. When the MAPI_LOGON_UI flag is not set, the calling client does not display a logon dialog box and returns an error value if the user is not logged on.


    An attempt should be made to create a new MAPI session instead of acquire the shared session. If the MAPI_NEW_SESSION flag is not set, MAPILogonEx uses an existing shared session even if the lpszprofileName parameter is not NULL.


    MAPI should not inform the MAPI spooler of the session's existence. The result is that no messages can be sent or received in the session except through a tightly coupled store and transport pair. A calling client sets this flag if it is acting as an agent, if configuration work must be done, or if the client is browsing the available message stores.


    The caller is running as a Windows service. Callers that are not running as a Windows service should not set this flag; callers that are running as a service must set this flag.


    MAPILogonEx should display a configuration dialog box for each message service in the profile. The dialog boxes are displayed after the profile has been chosen but before any message service is logged on. The MAPI common dialog box for logon also contains a check box that requests the same operation.


    The logon should fail if blocked for more than a few seconds.


    The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.


    The messaging subsystem should substitute the profile name of the default profilefor the lpszProfileName parameter. The MAPI_EXPLICIT_PROFILE flag is ignored unless lpszProfileName is NULL or empty.

    Wednesday, February 29, 2012 9:36 AM