IRTCSession::SendMessageStatus (Windows CE 5.0)
This method sends a user's typing status for a messaging window. The session must be of type RTCST_IM or RTCST_MULTIPARTY_IM.
HRESULT SendMessageStatus(RTC_MESSAGING_USER_STATUS enUserStatus,LONG_PTR lCookie);
Parameters
- enUserStatus
[in] An RTC_MESSAGING_USER_STATUS enumeration value specifying the user's status. - lCookie
[in] Pointer to an application-specified cookie used for pairing the notifications with the statuses sent.
Return Values
This method can return an RTC_E_ constant.
The following table shows additional information about specific return values.
| Value | Description |
|---|---|
| RTC_E_INVALID_SESSION_STATE | Message state must be RTCSS_INPROGRESS, RTCSS_INCOMING, or RTCSS_CONNECTED. |
| RTC_E_INVALID_SESSION_TYPE | Session must be of type RTCST_IM. |
Remarks
Completion is notified with an RTCE_MESSAGING event of type RTCMSET_STATUS.
Security Note This method can send data over the network in unencrypted form. Therefore, someone eavesdropping on the network might be able to read the data. Before using this method in an unencrypted session, consider the security risk of sending the data in clear text. The application can encrypt an RTC session by specifying TLS in the profile used for the session.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSession | IRTCSession::SendMessage | RTC_MESSAGING_USER_STATUS
Send Feedback on this topic to the authors