IRTCSession2::SendInfo (Windows CE 5.0)
This method sends a SIP INFO message. For this method to succeed, the session must be of type RTCST_PC_TO_PC, RTCST_PC_TO_PHONE, RTCST_MULTIPARTY_IM, or RTCST_IM.
HRESULT SendInfo( BSTR bstrInfoHeader, BSTR bstrInfo, LONG_PTR lCookie);
Parameters
bstrInfoHeader
[in] MIME header of the SIP INFO message.bstrInfo
[in] Body of the SIP INFO message, with the content encoded as the type specified by the MIME header.lCookie
[in] Pointer to an application-specific cookie that can be used for pairing notifications with the information sent.The application should guarantee a unique value for this cookie.
Return Values
This method can return an RTC_E_ constant.
The following table shows an additional return value and additional information about specific return values.
| Value | Meaning |
|---|---|
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
| RTC_E_INVALID_SESSION_STATE | The session is not in the incoming, connected, hold, refer, or in-progress state. |
| RTC_E_INVALID_SESSION_TYPE | The session type is not valid. |
| RTC_E_NOT_ALLOWED | This action is not allowed.
The RTC Client API uses the string "application/x-ms-mim" in the information header. This value is returned if this string is contained in the bstrInfoHeader parameter. |
Remarks
This method sends the SIP INFO message to all participants in the session.
An event of type RTC_SESSION_OPERATION_COMPLETE is fired for each participant in the session when the attempt to send the SIP INFO message has completed.
The IRTCSessionOperationCompleteEvent2 interface is used to fire this event.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSession2 | IRTCSessionOperationCompleteEvent2
Send Feedback on this topic to the authors