2024年3月14日发(作者：)

`WaitForSingleObjectEx`是一种Windows操作系统API函数，它

用于等待一个对象变为可用或信号状态。该函数提供了更高级的选项，

例如在等待期间可以响应操作系统的窗口消息。

函数的原型如下：

```c++

DWORD WaitForSingleObjectEx(

HANDLE hHandle,

DWORD dwMilliseconds,

BOOL bAlertable

);

```

参数解释：

* `hHandle`：要等待的对象句柄。这通常是一个事件、进程或线

程的句柄。

* `dwMilliseconds`：等待的超时时间，以毫秒为单位。如果设置

为 `INFINITE`，函数将无限期地等待。

* `bAlertable`：如果为 `TRUE`，则函数可以在等待期间响应操作

系统的窗口消息。如果为 `FALSE`，则函数不会响应这些消息。

返回值解释：

* 如果函数成功，则返回以下值之一：`WAIT_OBJECT_0`，

`WAIT_ABANDONED`，`WAIT_TIMEOUT` 或 `WAIT_FAILED`。

* `WAIT_OBJECT_0` 表示对象已变为可用状态。

* `WAIT_ABANDONED` 表示对象已被放弃，通常是由于存在句

柄泄漏。

* `WAIT_TIMEOUT` 表示在指定的超时时间内对象未变为可用状

态。

* `WAIT_FAILED` 表示函数调用失败，可以通过调用

GetLastError 获取错误代码以获取更多信息。

这个函数在需要对一个或多个系统对象进行同步处理的时候非

常有用，例如在多线程编程中，当一个线程需要等待另一个线程完成

某项任务后才能继续执行时，可以使用此函数。