SendMessage Method (MessageType, ContentType, Byte[])
Sends a message synchronously.
Namespace: Microsoft.Rtc.Signaling
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Public Function SendMessage ( _
messageType As MessageType, _
contentType As ContentType, _
body As Byte() _
) As SipResponseData
'Usage
Dim instance As SignalingSession
Dim messageType As MessageType
Dim contentType As ContentType
Dim body As Byte()
Dim returnValue As SipResponseData
returnValue = instance.SendMessage(messageType, _
contentType, body)
public SipResponseData SendMessage(
MessageType messageType,
ContentType contentType,
byte[] body
)
Parameters
- messageType
Type: Microsoft.Rtc.Signaling..::..MessageType
The type of the body (message or info).
- contentType
Type: System.Net.Mime..::..ContentType
The content type describing the body. If nullNothingnullptrunita null reference (Nothing in Visual Basic) text/plain, UTF-8 is assumed.
- body
Type: array<System..::..Byte>[]()[][]
The body for the data.
Return Value
Type: Microsoft.Rtc.Signaling..::..SipResponseData
A SipResponseData object containing the response data.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | Thrown when a non-nullNothingnullptrunita null reference (Nothing in Visual Basic) is expected for an argument. The argument name for which a non-nullNothingnullptrunita null reference (Nothing in Visual Basic) is expected is part of the exception message. |
| RealTimeException | Thrown when the server or remote participant returns an error. The response code in the exception should give more information about the error or encompasses an SIP error or failure cases encountered during sending the message - SIP Transport error, SIP Authentication, and credential-related errors. |
| ArgumentException | Thrown when invalid arguments are passed. |
| InvalidOperationException | Thrown when the session is an invalid state to send message. |
| FailureResponseException | Thrown when the server or remote participant returns an error. The SipResponseData in the exception should give additional information. |
| ServerPolicyException | Thrown when a server policy setting does not allow the sending of the message. |
Remarks
The session should be in the Connected state. This method is not recommended for a UI thread.