ApplicationListMsg Class

10/16/2008

This class represents a supported MSN Direct service-list query message.

Syntax

class ApplicationListMsg : public Msg

Methods

Method	Description
ApplicationListMsg Constructor	Initializes the fields of this class by calling the Init method.
ApplicationListMsg::AddApplication	Adds the specified application identifier to the list of MSN Direct services in the MSN Direct receiver and increments the count of supported MSN Direct services.
ApplicationListMsg::FinishMessage	Writes the end-of-frame for this application-list message.
ApplicationListMsg::GetApplicationType	Returns the MSN Direct service type of this application-list message.
ApplicationListMsg::GetBuffer	Returns a pointer to the first byte of this application-list message after the beginning-of-frame.
ApplicationListMsg::GetBufferWithFrames	Returns a pointer to the first byte of this application-list message, including the bytes that are used for framing.
ApplicationListMsg::GetErrorCode	Returns the error code for this application-list message.
ApplicationListMsg::GetNumberOfApps	Returns the number of supported MSN Direct services.
ApplicationListMsg::GetSize	Returns the size of this application-list message, subtracting the bytes that are used for framing.
ApplicationListMsg::GetSizeWithFrames	Returns the size of this application-list message, including the bytes that are used for framing.
ApplicationListMsg::GetTransactionId	Returns the transaction ID of this application-list message.
ApplicationListMsg::Init	Initializes the fields of this class.
ApplicationListMsg::IsResponse	Returns true if this application-list message is a response message.
ApplicationListMsg::SetApplicationType	Sets the MSN Direct service type for this application-list message.
ApplicationListMsg::SetCRC	Computes and sets the Cyclic Redundancy Check (CRC) value for this application-list message.
ApplicationListMsg::SetErrorCode	Sets the error code for this application-list message.
ApplicationListMsg::SetFrame	Writes both the beginning-of-frame bytes and the end-of-frame bytes
ApplicationListMsg::SetNumberOfApps	Sets the number of supported MSN Direct services.
ApplicationListMsg::SetResponse	Sets the last bit of the transaction ID to indicate whether this simple host message is a response message.
ApplicationListMsg::SetTransactionId	Sets the transaction ID of this application-list message.

Remarks

This class inherits from the Msg Class.

This system message enables the MSN Direct receiver to inform the MSN Direct application on the host device of the list of available MSN Direct services. It also enables the host device to selectively turn on or turn off specific services in the receiver.

When a connection is established between the host device and the MSN Direct receiver, the receiver sends a message to the host device which contains the list of MSN Direct services that the receiver can support.

A host device can disable any MSN Direct service by initiating this message. It must call AddApplication to create an exclusive list of MSN Direct services in the message that it wants enabled. The receiver will respond with a list of all MSN Direct services that it supports.

The receiver maintains these settings after the connection to the host device is disconnected and reconnected.

When the MSN Direct service type is APPLICATION_LIST, the incoming message is an MSN Direct service-list query message. You can typecast it to an ApplicationListMsg object.

In MSN Direct services for Windows Embedded CE, the host device is the Windows Embedded CE–based device.

Requirements

Header	DBRLib.h
Library	DBRLib.lib
Windows Embedded CE	Windows CE 5.0, Windows Embedded NavReady 2009

See Also

Reference

MSN Direct Services Classes