MAPIINIT_0

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Conveys options to the MAPIInitialize function.

Header file:

MAPIX.H

typedef struct
{
  ULONG ulVersion;
  ULONG ulFlags;
} MAPIINIT_0, FAR *LPMAPIINIT_0;

Members

  • ulVersion
    Integer value that represents the version number of the MAPIINIT_0 structure. The ulVersion member is for future expansion and does not represent the version of the MAPI interface. Currently, ulVersion must be set to MAPI_INIT_VERSION.

  • ulFlags
    Bitmask of flags used to control the initialization of the MAPI session. The following flags can be set:

    • MAPI_MULTITHREAD_NOTIFICATIONS
      MAPI should generate notifications using a thread dedicated to notification handling instead of the first thread used to call MAPIInitialize.

    • 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.

Remarks

Multithreaded clients should set the MAPI_MULTITHREADED_NOTIFICATIONS flag. If the flag is not set, notifications are generated on the thread used to make the first call to MAPIInitialize.

For more information about when to set this flag and how to implement thread safety in a client, see Threading in MAPI.

See Also

Reference

MAPIInitialize

Concepts

MAPI Structures