none
MAPILOGONEX FLFLAGS QUESTION

    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!

    flFlags

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

    MAPI_ALLOW_OTHERS

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

    MAPI_EXPLICIT_PROFILE

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

    MAPI_EXTENDED

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

    MAPI_FORCE_DOWNLOAD

    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.

    MAPI_LOGON_UI

    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.

    MAPI_NEW_SESSION

    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_NO_MAIL

    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.

    MAPI_NT_SERVICE

    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.

    MAPI_SERVICE_UI_ALWAYS

    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.

    MAPI_TIMEOUT_SHORT

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

    MAPI_UNICODE

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

    MAPI_USE_DEFAULT

    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