Configuring the SNTP Service
Other versions of this page are also available for the following:
.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.")
8/28/2008
You can use Input/Output Controls (IOCTLs) to configure and manage the SNTP service. These IOCTLs are defined in Service.h and provide a standard method for managing services in Windows Embedded CE using Services.exe. To send an IOCTL to the service, the application must call the DeviceIoControl function on an open service handle. DeviceIoControl then calls the service-related xxx_IOControl (Services.exe) function, and passes in the IOCTL as the dwCode parameter.
The following table shows the IOCTLs that SNTP supports.
| IOCTL | Implementation |
|---|---|
Standard |
|
Standard |
|
Standard |
|
Standard |
|
Custom |
For more information about using IOCTLs to manage a service, see Controlling a Running Service.
SNTP defines a customized input parameter (dwInBufSize) for the IOCTL_SERVICE_CONTROL IOCTL. The dwInBufSize parameter contains the size of the string, in bytes, including the terminating '\0' value. The lpinBuffer parameter in DeviceIoControl points to this null-terminated Unicode string. The following table shows the values and descriptions of these strings.
| Value | Description |
|---|---|
Sync |
Synchronizes the system with the external NTP server, and sets the time according to the settings defined in the registry. |
Set |
Synchronizes the system with the external NTP server, and forces the system time to be set, regardless of any time differences between system and server. |
Update |
Specifies that an external time update has occurred. If multicast is enabled, the time change will be broadcast. |
If a notification subsystem is present on your system, SNTP listens for system wakeups and time changes. For more information about implementing a notification subsystem, see Implementing Notifications.
If your OS design includes the IP Helper API Catalog item, SNTP also listens to notifications of IP address changes. SNTP attempts to synchronize as soon as a connection to the network has been established. For more information about IP Helper, see Internet Protocol Helper APIs.
See Also
Tasks
SNTP Service Configuration Code Sample
Reference
Services.exe IOCTLS
xxx_IOControl (Services.exe)
Concepts
Simple Network Time Protocol (SNTP) OS Design Development
SNTP Registry Settings
Services.exe Registry Settings
Controlling a Running Service
IOCTLs that are Sent by Applications