Protocols/MSNP/Activities/SDK/Techref/Objectmodel/Objects/Channel/Methods/SendIM
<a class="clsStd" href="/techref/objectmodel/objects/channel/index.htm">Channel</a>.SendIM Method (Restricted)
This method sends an instant message that appears to come from the application. The method is labeled "restricted" because it requires the SendIM permission flag. For more information, see Standard vs. Advanced Applications.
VBScript Syntax
Dim myChannel
Dim myOutput
set myChannel = external.Channel
myOutput = "That's checkmate!"
sub cmdSendIMButton_OnClick
' Send an instant message that appears to come from the application.
On Error Goto Handler
myChannel.SendIM(myOutput)
Exit Sub
:Handler
Document.Write("SendIM failed. Error Description: " & err.description)
End Sub
JavaScript Syntax
var myChannel;
var myOutput;
myChannel = window.external.Channel;
myOutput = "That's checkmate!";
function cmdSendIMButton_OnClick() {
// Send an instant message that appears to come from the application.
try {
myChannel.SendIM(myOutput);
}
catch(ex) {
document.write("SendIM failed. Error Description: " + ex.description);
}
}
Parameters
- myIM
- A string containing the data to be sent as an instant message.
Return Values
No return value.
Remarks
An exception is thrown if the application does not have SendIM permission, or if the instant message could not be sent.