2.2.14 W32TIME_CONFIGURATION_BASIC

The W32TIME_CONFIGURATION_BASIC structure defines the basic configuration data of the time service.

The structure is defined to match the basic configuration of the W32Time implementation, as described in [WTSREF]. Fields in the structure that are not valid in other implementations SHOULD have their corresponding configuration-setting type fields set to W32TIME_CONFIGURATION_SETTING_UNDEFINED.<12>

 typedef struct {
   unsigned __int32 ulSize;
   unsigned __int32 ulEventLogFlags;
   unsigned __int32 ulAnnounceFlags;
   unsigned __int32 ulTimeJumpAuditOffset;
   unsigned __int32 ulMinPollInterval;
   unsigned __int32 ulMaxPollInterval;
   unsigned __int32 ulMaxNegPhaseCorrection;
   unsigned __int32 ulMaxPosPhaseCorrection;
   unsigned __int32 ulMaxAllowedPhaseOffset;
   unsigned __int32 ulEventLogFlagsFlag;
   unsigned __int32 ulAnnounceFlagsFlag;
   unsigned __int32 ulTimeJumpAuditOffsetFlag;
   unsigned __int32 ulMinPollIntervalFlag;
   unsigned __int32 ulMaxPollIntervalFlag;
   unsigned __int32 ulMaxNegPhaseCorrectionFlag;
   unsigned __int32 ulMaxPosPhaseCorrectionFlag;
   unsigned __int32 ulMaxAllowedPhaseOffsetFlag;
 } W32TIME_CONFIGURATION_BASIC,
  *PW32TIME_CONFIGURATION_BASIC;

ulSize: The size, in bytes, of this structure.

ulEventLogFlags: The EventLogFlags element value (see section 3.2.1.1).

ulAnnounceFlags: An integer that indicates the combination of flags that determines how the time service advertises itself as a time server. The value MUST be a bitwise OR of zero or more of the following flags.

Value

Meaning

Timeserv_Announce_No

0x00000000

Not a time server.

Timeserv_Announce_Yes

0x00000001

Always advertised as a time server.

Timeserv_Announce_Auto

0x00000002

Advertising as a time server is decided automatically: only when the server is synchronized.

Reliable_Timeserv_Announce_Yes

0x00000004

Always advertised as a reliable time server.

Reliable_Timeserv_Announce_Auto

0x00000008

Advertising as a time server is decided automatically: only when the server is synchronized and is a reliable time server.

All other values are reserved for future use.

ulTimeJumpAuditOffset: The TimeJumpAuditOffset element value (see section 3.2.1.1).

ulMinPollInterval: An integer that indicates the minimum poll interval of domain time synchronization, expressed as specified in [RFC1305] section 3.2.7, using units of seconds given as exponents to a power of two.

ulMaxPollInterval: An integer that indicates the maximum poll interval of domain time synchronization, expressed as specified in [RFC1305] section 3.2.7, using units of seconds given as exponents to a power of two.

ulMaxNegPhaseCorrection: The MaxNegPhaseCorrection element value (see section 3.2.1.1).

ulMaxPosPhaseCorrection: The MaxPosPhaseCorrection element value (see section 3.2.1.1).

ulMaxAllowedPhaseOffset: The MaxAllowedPhaseOffset element value (see section 3.2.1.1).

ulEventLogFlagsFlag: An integer that indicates the source of the configuration setting for ulEventLogFlags, as specified in section 2.2.6.

ulAnnounceFlagsFlag: An integer that indicates the source of the configuration setting for ulAnnounceFlags, as specified in section 2.2.6.

ulTimeJumpAuditOffsetFlag: An integer that indicates the source of the configuration setting for ulTimeJumpAuditOffset, as specified in section 2.2.6.

ulMinPollIntervalFlag: An integer that indicates the source of the configuration setting for ulMinPollInterval, as specified in section 2.2.6.

ulMaxPollIntervalFlag: An integer that indicates the source of the configuration setting for ulMaxPollInterval, as specified in section 2.2.6.

ulMaxNegPhaseCorrectionFlag: An integer that indicates the source of the configuration setting for ulMaxNegPhaseCorrection, as specified in section 2.2.6.

ulMaxPosPhaseCorrectionFlag: An integer that indicates the source of the configuration setting for ulMaxPosPhaseCorrection, as specified in section 2.2.6.

ulMaxAllowedPhaseOffsetFlag: An integer that indicates the source of the configuration setting for ulMaxAllowedPhaseOffset, as specified in section 2.2.6.