TimeProvOpen function (timeprov.h)

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

See also

AlertSamplesAvailFunc

GetTimeSysInfoFunc

LogTimeProvEventFunc

SetProviderStatusFunc

TimeProvSysCallbacks