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 |