Share via

3.2.5.5 W32TimeQueryProviderConfiguration (Opnum 4)

  • Article

The W32TimeQueryProviderConfiguration method returns configuration data for a specific time provider within the time service's list of time providers.<44> The MIDL syntax of this method is specified as follows.

 unsigned long W32TimeQueryProviderConfiguration(
   [in] handle_t hBinding,
   [in] unsigned __int32 ulFlags,
   [in, string] wchar_t* pwszProvider,
   [out, ref] PW32TIME_CONFIGURATION_PROVIDER* pConfigurationProviderInfo
 );

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

ulFlags: Reserved. This parameter MUST be set to zero and MUST be ignored on receipt.

pwszProvider: A null-terminated string that is the name of the time provider to query. This name is implementation specific.<45>

pConfigurationProviderInfo: A pointer that receives a pointer to a W32TIME_CONFIGURATION_PROVIDER structure containing configuration data for the time provider.

Return Values: This method MUST return zero 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.<46>

When W32TimeQueryProviderConfiguration is invoked, the server SHOULD examine its TimeProviderList to locate the time provider corresponding to the name pwszProvider. If the provider cannot be located, the server MUST return ERROR_NOT_FOUND, as specified in [MS-ERREF]; otherwise, the server MUST return the associated time provider configuration data structure, as specified in section 3.2.5.9.1.