WaitForSingleObject

WaitForSingleObject 是一个 API 函数，用于等待一个内核对象的信号状态。该函数可以用于等待 WindowsEvent 对象、互斥量、信号量等内核对象的信号状态。

WaitForSingleObject 函数可以指定等待的对象句柄、等待超时时间和是否在等待期间允许操作系统调度其他线程。该函数在等待期间会阻塞当前线程，直到等待对象的信号状态变为有信号或等待超时。

如果等待对象的信号状态在函数调用前就已经是有信号状态，那么该函数会立即返回，否则会等待直到等待超时或等待对象的信号状态变为有信号状态。

在 TightVNC 中，WaitForSingleObject 函数被广泛用于等待 WindowsEvent 对象的信号状态，以实现线程同步和互斥操作。例如，在 TightVNC 服务器端，处理线程会调用 WaitForSingleObject 等待连接请求事件的信号状态，以保证处理线程只处理一个连接请求，避免出现竞争条件。