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.