3.2.5.4 W32TimeQuerySource (Opnum 3)

  • Article

The W32TimeQuerySource method returns the current time source of the time service. The MIDL syntax of this method is specified as follows.

 unsigned long W32TimeQuerySource(
   [in] handle_t hBinding,
   [out, string] wchar_t** pwszSource
 );

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

pwszSource: A pointer to a null-terminated string that is the name of the time source that the time service is synchronizing with. If the time service is not synchronizing with any time source, the string MUST be set to a null-terminated empty string. This string SHOULD be either the FQDN or the IP address of the time source in the form of a string, for example, "ntp1.nist.gov" or "10.0.0.1".

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.<42>

When W32TimeQuerySource is invoked, the server SHOULD return the current time source of the time service.<43>