3.2.5.7 W32TimeQueryStatus (Opnum 6)

The W32TimeQueryStatus method returns the service status data of the time service.<49> The MIDL syntax of this method is specified as follows.

 unsigned long W32TimeQueryStatus(
   [in] handle_t hBinding,
   [out, ref] PW32TIME_STATUS_INFO* pStatusInfo
 );

hBinding: RPC primitive binding handle as specified in [C706] part 3, sections Interface Definition Language and Stubs.

pStatusInfo: A pointer that receives a pointer to a W32TIME_STATUS_INFO structure containing status data for the time service.

Return Values: This method MUST return 0 on success; on failure, it returns a nonzero error code. The values transmitted in this field are implementation specific. All nonzero values MUST be treated as equivalent for the purposes of this protocol.<50>

When W32TimeQueryStatus is invoked, the server MUST return the associated time service status data structure, as specified in section 2.2.17, and populate it as follows:

Element field	Value
ulSize	The size, in bytes, of the W32TIME_STATUS_INFO structure.
eLeapIndicator	The Leap Indicator (sys.leap), as specified in [RFC1305] section 3.2.1, "Common Variables".
nStratum	The Stratum (sys.stratum), as specified in [RFC1305] section 3.2.1, "Common Variables".
nPollInterval	The Poll Interval (sys.poll), as specified in [RFC1305] section 3.2.1, "Common Variables".
refidSource	The Reference Clock Identifier (sys.refid), as specified in [RFC1305] section 3.2.1, "Common Variables".
qwLastSyncTicks	The LastSyncTicks element value (section 3.2.1.1).
toRootDelay	The Root Delay (sys.rootdelay), as specified in [RFC1305] section 3.2.1, "Common Variables".
tpRootDispersion	The Root Dispersion (sys.rootdispersion), as specified in [RFC1305] section 3.2.1, "Common Variables".
nClockPrecision	The Precision (sys.precision), as specified in [RFC1305] section 3.2.1, "Common Variables".
wszSource	The TimeSourceIPAddress element value (section 3.2.1.1).
toSysPhaseOffset	The SysPhaseOffset element value (section 3.2.1.1).
ulLcState	The CurrentState element value (section 3.2.1.1).
ulTSFlags	The TimeSourceFlags element value (section 3.2.1.1).
ulClockRate	The ClockRate element value (section 3.2.1.1).
ulNetlogonServiceBits	An unsigned, 32-bit integer that contains information about the functionality that the time service provides, as specified in section 3.2.5.2.
eLastSyncResult	An integer that indicates the TimeSync_ReturnResult code, as specified in section 3.2.5.1.
tpTimeLastGoodSync	The TimeLastGoodSync element value (section 3.2.1.1).
cEntries	0
pEntries	NULL