Share via

2.2.5 W32TIME_NTP_PEER_INFO

  • Article

The W32TIME_NTP_PEER_INFO structure defines the current state of a time peer for an NTP time provider.

 typedef struct {
   unsigned __int32 ulSize;
   unsigned __int32 ulResolveAttempts;
   unsigned __int64 u64TimeRemaining;
   unsigned __int64 u64LastSuccessfulSync;
   unsigned __int32 ulLastSyncError;
   unsigned __int32 ulLastSyncErrorMsgId;
   unsigned __int32 ulValidDataCounter;
   unsigned __int32 ulAuthTypeMsgId;
   [string, unique] wchar_t* wszUniqueName;
   unsigned char ulMode;
   unsigned char ulStratum;
   unsigned char ulReachability;
   unsigned char ulPeerPollInterval;
   unsigned char ulHostPollInterval;
 } W32TIME_NTP_PEER_INFO,
  *PW32TIME_NTP_PEER_INFO;

ulSize: The size, in bytes, of this structure.<8>

ulResolveAttempts: The ResolvedAttempts element value (see section 3.2.1.3).

u64TimeRemaining: The TimeRemaining element value (see section 3.2.1.3).

u64LastSuccessfulSync: The LastSuccessfulSync element value (see section 3.2.1.3).

ulLastSyncError: The LastSyncError element value (see section 3.2.1.3).

ulLastSyncErrorMsgId: The LastSyncErrorMessageId element value (see section 3.2.1.3).

ulValidDataCounter: The ValidDataCounter element value (see section 3.2.1.3).

ulAuthTypeMsgId: The AuthenticationTypeMessageId element value (see section 3.2.1.3).

wszUniqueName: The PeerName element value (see section 3.2.1.3).

ulMode: This time peer's current NTP association mode, as specified in [RFC1305] section 3.2.1, "Common Variables".

ulStratum: This time peer's stratum level, which indicates the distance between this time peer and a reference source. This value is compared with other peers' stratum levels to ensure that a machine closer to a reference source is not synchronized to a machine that is farther away, as specified in [RFC1305] section 2.2, "Network Configurations".

ulReachability: An 8-bit shift register that contains this time peer's reachability, as specified in [RFC1305] section 3.2.3, "Peer Variables".

ulPeerPollInterval: This time peer's poll interval, expressed as specified in [RFC1305], using units of seconds given as exponents to a power of two. For example, a value of six indicates a minimum interval of 64 seconds.

ulHostPollInterval: The interval at which the NTP service provider is polling this time peer, expressed as specified in [RFC1305], using units of seconds given as exponents to a power of two. For example, a value of six indicates a minimum interval of 64 seconds.