POSIX Threads for Windows – REFERENCE - Pthreads-w32

Reference Index

Table of Contents


pthread_timechange_handler_np – alert timed waiting condition variables to system time changes.


#include <pthread.h>

void * pthread_timechange_handler_np(void * dummy);


To improve tolerance against operator or time service initiated system clock changes.

pthread_timechange_handler_np can be called by an application when it receives a WM_TIMECHANGE message from the system. At present it broadcasts all condition variables so that waiting threads can wake up and re-evaluate their conditions and restart their timed waits if required.

pthread_timechange_handler_np has the same return type and argument type as a thread routine so that it may be called directly through pthread_create(), i.e. as a separate thread. If run as a thread, the return code must be retrieved through pthread_join().

Although the dummy parameter is required it is not used and any value including NULL can be given.



Return Value

pthread_timechange_handler_np returns 0 on success, or an error code.


The pthread_timechange_handler_np function returns the following error code on error:


To indicate that not all condition variables were signalled for some reason.


Ross Johnson for use with Pthreads-w32.

Table of Contents