ScMAPIXFromSMAPI

Applies to: Outlook 2013 | Outlook 2016

Converts a simple MAPI session to a MAPI session.

Property	Value
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] The simple MAPI session that was created by a call to MAPILOGON.

ulFlags

[in] Reserved; must be zero.

lpInterface

[in] A pointer to the interface identifier (IID) that represents the interface to be used to access the session. Passing NULL causes the lppMAPISession parameter to return a pointer to the standard interface for a MAPI session (IMAPISession).

lppMAPISession

[out] Pointer to a pointer to the MAPI session interface.

Return value

S_OK

The simple MAPI session was successfully converted to a MAPI session.

MAPI_E_INVALID_PARAMETER

lhSimpleSession could not be converted to a MAPI session.

MAPI_E_UNKNOWN_FLAGS

ulFlags contained invalid flags.

E_NOINTERFACE

The session could not be converted into the interface specified by lpInterface.

Remarks

There are no inverse functions for ScMAPIXFromSMAPI function, that is, a client cannot convert to a simple MAPI session from a MAPI session.

See also

MAPILOGON

MAPILogonEx