void OnChannelMessage(
	string message
)

void OnChannelMessage(
	[InAttribute] String^ message
)

function OnChannelMessage(message);

Parameters

message

Type: SystemString
String containing the data payload included by the application server, encoded in UTF-8.

This callback will be invoked when a Push Channel notification is received on the associated Push Channel. The message will have been sent by the application server, using the Push Channel notify service, which is hosted by the BlackBerry Dynamics Network Operation Center (NOC).

The service supports a "payload" of data to be included in the notification. The data could be in any format chosen by the application developer. The payload could also be empty.

Note that Push Channel notifications can be received at any time when the channel is open, and the Push Connection is open and operating. This includes the interval between the request for disconnection (Disconnect called) and channel disconnection being finalized (OnChannelClose(String) received).

The function that is invoked could initiate the following actions:

• Alert the user that new data is available.
• Connect to the application server to retrieve the data.

Reference