Protocols/MSNP/Activities/SDK/Techref/Objectmodel/Objects/Channel/Properties/IMro
<a class="clsStd" href="/techref/objectmodel/objects/channel/index.htm">Channel</a>.IM (read-only) Property (Restricted)
This property returns a string containing the instant message that has been received. It contains new data whenever the OnIMReceived event fires. This property is read-only and is labeled "restricted" because it is only available if the application has the ReceiveIM permission. For more information, see Standard vs. Advanced Applications.
VBScript Syntax
external.Channel.IM
JavaScript Syntax
window.external.Channel.IM
Property Value
A string object containing the instant message received from the remote MSN® Messenger client.
Example
This example illustrates the display of a received instant message.
// Receiving the contents of an IM requires ReceiveIM permission flag.
var myChannel = window.external.Channel;
function Channel_OnIMReceived() {
var myLocalCopy;
myLocalCopy = myChannel.IM;
txtDebugOut.innerHTML = "Received: " + myLocalCopy;
}
Remarks
This property contains data that should be inspected every time the OnIMReceived event occurs.