RILNITZINFO
A version of this page is also available for
4/8/2010
The RILNITZINFO notification structure contains information that is returned upon notification of a NITZ related event.
Syntax
typedef struct {
DWORD cbSize;
DWORD dwParams;
DWORD dwNotificationCode;
int TimeZoneOffsetMinutes;
int DaylightSavingOffsetMinutes;
SYSTEMTIME SysTime;
} RILNITZINFO;
Members
- cbSize
Contains the structure size, in bytes.
dwParams
Indicates which of the data:TimeZoneOffsetMinutes, DaylightSavingsOffsetMinutes, and SYSTEMTIME structure members contain valid data.The value for dwParams is found by logically ORing the constants associated with one or more of the members, listed earlier, that contain valid data. The structure members are represented by the following constants:
- RIL_PARAM_NITZ_SYSTEMTIME = 0x00000001
- RIL_PARAM_NITZ_TIMEZONEOFFSET = 0x00000002
- RIL_PARAM_NITZ_DAYLIGHTSAVINGOFFSET = 0x00000004
- dwNotificationCode
Specifies the type of notification, indicated by the RIL_NOTIFY_NITZ constant. For more information, see, Notification Miscellaneous Constants.
- TimeZoneOffsetMinutes
Contains time and date information.
- DaylightSavingOffsetMinutes
Contains the offset for Daylight Saving Time
- SysTime
Contains the system time, if available from the network. It should be Coordinated Universal Time (UTC).
Remarks
Your code must not call SetSystemTime or SetLocalTime between the time that the RIL driver sends a RIL_NOTIFY_NITZ notification and the Windows Mobile operating system (OS) processes the notification. This could cause a race condition between the time requests and the RIL driver's NITZ information might not be processed.
Requirements
| Header | ril.h |
| Windows Embedded CE | Windows CE 5.0 and later |