DBR701::GetWeatherAlerts
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
10/16/2008
This method requests up-to-date data for weather alerts from the MSN Direct receiver. A weather alert describes a weather event in the local area.
This method is obsolete. Please use the signed CAP-compatible emergency and supplemental alerts. For more information, see GetCapEmergencyAlertsCore and GetCapEmergencyAlertsSuppl.
Syntax
int GetWeatherAlerts();
Parameters
None.
Return Value
Returns the transaction ID of the request that is sent to the MSN Direct receiver; returns -1 if the request fails.
Remarks
The GetWeatherAlerts method uses RequestSync to perform the transaction, with WEATHER_ALERTS specified in the applicationType parameter.
The weather-alerts messages are returned asynchronously in the messageFromReceiver parameter of the ProcessInMessageFromReceiver call. The WeatherAlertsMsg object in the sample application illustrates how to parse this type of message.
Warning
The functions in the sample message classes handle data that arrives in a specific format in the payload of an incoming message. If you modify the way in which data is extracted from incoming messages, the message classes will not work as expected.
Requirements
| Header | DBR701.h |
| Library | DBRLib.lib |
| Windows Embedded CE | Windows CE 5.0, Windows Embedded NavReady 2009 |
See Also
Tasks
Adding Custom Classes for Incoming Messages
Reference
DBR701::GetWeather
DBR701::GetNonLocalWeather
DBR701 Class
MSN Direct Services Classes