AlertSamplesAvailFunc callback function (timeprov.h)

Notifies the system that there are new time samples available.


AlertSamplesAvailFunc Alertsamplesavailfunc;

HRESULT Alertsamplesavailfunc()


This callback function has no parameters.

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.


The time provider manager uses this notification to determine when to send a TPC_GetSamples command. A hardware provider does not need to call this function, as the time provider manager requests samples without this notification. Time providers that provide samples sporadically, such as a provider that works in the background when a user establishes a transient dial-up connection, must call this function.

The TimeProvOpen function returns a pointer to this function.


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

See also