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 Simple MAPI session to a MAPI session.

Remarks

There are no inverse functions for either the ScMAPIXFromCMC 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 Interfaces and Explicit Logon with Simple MAPI.