ScMAPIXFromSMAPI

The ScMAPIXFromSMAPI function enables a client application to pass in a Simple MAPI session handle and get back a pointer to a MAPI session object.

Quick Info

Header file:

MAPI.H

Implemented by:

MAPI

Called by:

Client applications

 

SCODE ScMAPIXFromSMAPI(

    LHANDLE lhSimpleSession,

 

    ULONG ulFlags,

 

    LPCIID lpInterface,

 

    LPMAPISESSION FAR * lppMAPISession

 

   );

 

 

Parameters

lhSimpleSession

[in] Pointer to a Simple MAPI session.

ulFlags

Reserved; must be zero.

lpInterface

[in] The MAPI interface to be returned.

lppMAPISession

[out] Pointer to a variable where a pointer for a specific MAPI session is stored.

 

Return Values

S_OK

The call succeeded and has converted the SMAPI session to a MAPI session.

 

Remarks

There are no inverse functions for either the ScMAPIXFromCMC2MVABYJ or ScMAPIXFromSMAPI function, that is, a client cannot convert to a CMC session or Simple MAPI session from a MAPI session. Also, a client cannot convert from a Simple MAPI session to a CMC session.

For more information on using this function, see Using Multiple Client InterfacesUGTSUQ and Explicit Logon with Simple MAPI0K1Z3P.