LocationMsg Class

10/16/2008

This class contains information about a World Geodetic System (WGS-84) location on earth.

Syntax

class LocationMsg : public Msg 

Methods

Method	Description
LocationMsg Constructor	Initializes the data fields of this class.
LocationMsg::GetApplicationType	Returns the MSN Direct service type for this message.
LocationMsg::GetBuffer	Returns a pointer to the first byte of the message after the beginning-of-frame.
LocationMsg::GetBufferWithFrames	Returns a pointer to the first byte of this message, including framing.
LocationMsg::GetSize	Returns the size of this location message, subtracting framing.
LocationMsg::GetSizeWithFrames	Returns the size of this location message, including the bytes used for framing.
LocationMsg::GetTransactionId	Returns the transaction ID of this location message.
LocationMsg::Init	Initializes the data fields of this class.
LocationMsg::IsResponse	Returns true if this message is a response message.
LocationMsg::RawMessageSize	Returns the size of this location message, including framing.
LocationMsg::SetApplicationType	Sets the MSN Direct service type for this location message.
LocationMsg::SetCRC	Computes and sets the Cyclic Redundancy Check (CRC) value for the current message.
LocationMsg::SetErrorCode	Sets the error code for this location message.
LocationMsg::SetHeading	Sets the compass heading, in degrees.
LocationMsg::SetLocation	Sets the World Geodetic System (WGS-84) location for this location message.
LocationMsg::SetResponse	Sets the last bit of the transaction ID to indicate whether this location message is a response message.
LocationMsg::SetSpeed	Sets the speed at which the host device is traveling, in miles per hour (MPH).
LocationMsg::SetTime	Sets the time stamp for this location message.
LocationMsg::SetTransactionId	Sets the transaction ID for this location message.
LocationMsg::SetVoidData	Sets a void location, time, speed, and heading.
LocationMsg::SetVoidHeading	Sets an empty compass heading for this location message.
LocationMsg::SetVoidLocation	Sets a void location for this location message.
LocationMsg::SetVoidSpeed	Sets an empty speed value for this location message.
LocationMsg::SetVoidTime	Sets an empty time stamp for this location message.

Remarks

This class inherits from the Msg Class.

The MSN Direct receiver sends this message in order to determine the World Geodetic System (WGS-84) location of the host device and the current local time of the host device. With specific location information, the receiver can send the host device location-based up-to-date data, such as traffic alerts.

If the MSN Direct service type of the incoming message is LOCATION_DATA, you can typecast it to a LocationMsg object and supply the object with the location data.

You must populate the fields of this class with location data derived by using GPS technology.

This message can only be used in transactions that are initiated by the MSN Direct receiver.

Requirements

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

See Also

Reference

WGS84 Class
MSN Direct Services Classes
GPSMsg Class