Share via


IMsgrSessionManager::CreateSession method

[CreateSession is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Creates a new MsgrSession object.

Syntax

HRESULT CreateSession(
  [out, retval] IDispatch **ppSession
);

Parameters

ppSession [out, retval]

Type: IDispatch**

Sets Address of a pointer to an IDispatch interface that returns the new session object.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
The MsgrSession object was created successfully.
E_INVALIDARG
The parameter passed to the method was not valid.
E_OUTOFMEMORY
The MsgrSession object cannot be created.

Remarks

The following table lists the error codes returned by this method.

Error Code Meaning
0x8007000E The MsgrSession object cannot be created because the system has run out of memory.
0x80070057 The parameter passed to the method was not valid.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Product
Messenger 4.5
Header
Msgrpriv.h
IDL
Msgrpriv.idl
DLL
Msgsc.dll

See also

IMsgrSessionManager

MsgrSession

Messenger Session Invite and Messenger Private APIs

Messenger Lock and Key API