Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The RILNITZINFOnotification 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 SYSTEMTIMEstructure members contain valid data.

The value for dwParamsis 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_NITZconstant. 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 SetSystemTimeor SetLocalTimebetween the time that the RIL driver sends a RIL_NOTIFY_NITZnotification 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

See Also