TimeProvOpen function (timeprov.h)

Article
02/22/2024

A callback function that is called by the time provider manager when the time provider DLL is loaded.

Syntax

HRESULT TimeProvOpen(
  [in]  PWSTR                wszName,
  [in]  TimeProvSysCallbacks *pSysCallbacks,
  [out] TimeProvHandle       *phTimeProv
);

Parameters

[in] wszName

The provider name.

[in] pSysCallbacks

A pointer to a TimeProvSysCallbacks structure that specifies pointers to the functions provided by the time service to the time provider. The system allocates this structure, and it is destroyed when the function returns. Therefore, you must copy the information to another buffer.

[out] phTimeProv

A pointer to a buffer that contains a handle to the provider. The time provider manager uses this handle to communicate with the time provider.

Return value

If the function succeeds, the return value is S_OK. Otherwise, the return value is one of the error codes defined in WinError.h.

Remarks

You should return from this callback function as quickly as possible. Perform any initialization in another thread.

Examples

For an example, see Sample Time Provider.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	timeprov.h