WaitForSingleObject

函数功能

使用WaitForSingleObject函数来等待一个内核对象变为已通知状态
函数原型

DWORD WaitForSingleObject(
HANDLE hObject, //指明一个内核对象的句柄
DWORD dwMilliseconds); //等待时间

函数参数

函数返回值
该函数需要传递一个内核对象句柄，该句柄标识一个内核对象
① 如果该内核对象处于未通知状态，则该函数导致线程进入阻塞状态；
② 如果该内核对象处于已通知状态，则该函数立即返回WAIT_OBJECT_0。

第二个参数指明了需要等待的时间（毫秒），可以传递INFINITE指明要无限期等待下去，如果第二个参数为0，那么函数就测试同步对象的状态并立即返回。如果等待超时，该函数返回WAIT_TIMEOUT

使用举例

DWORD dw = WaitForSingleObject(hProcess, 5000); //等待一个进程结束
switch (dw)
{
case WAIT_OBJECT_0:
// hProcess所代表的进程在5秒内结束
break;

case WAIT_TIMEOUT:
// 等待时间超过5秒
break;

case WAIT_FAILED:
// 函数调用失败，比如传递了一个无效的句柄
break;
}