在Windows中,`WaitForSingleObject`是一个函数,用于等待一个或多个内核对象的状态发生变化。该函数的原型如下:
DWORD WaitForSingleObject(
HANDLE hObject,
DWORD dwMilliseconds
);
参数解释如下:
`hObject`:要等待的内核对象的句柄。
`dwMilliseconds`:指定等待的时间,以毫秒为单位。可以使用特定值来控制等待的行为。
返回值表示函数执行结果,可能的取值如下:
`WAIT_OBJECT_0`:成功等待到了对象的信号。
`WAIT_TIMEOUT`:等待超时。
`WAIT_FAILED`:等待失败,可能是由于传入的参数无效或其他原因。
下面是一个示例,展示了如何使用`WaitForSingleObject`等待一个线程的结束:
#include
#include
DWORD WINAPI MyThreadProc(LPVOID lpParam)
{
// 在这里执行线程的任务
// ...
return 0;
}
int main()
{
HANDLE hThread;
DWORD dwThreadId;
// 创建线程
hThread = CreateThread(
NULL, // 默认安全属性
0, // 默认线程栈大小
MyThreadProc, // 线程函数地址
NULL, // 传递给线程函数的参数
0, // 默认标志
&dwThreadId // 返回线程ID
);
if (hThread == NULL)
{
printf("Failed to create thread\n");
return 1;
}
// 等待线程结束
DWORD dwResult = WaitForSingleObject(hThread, INFINITE);
if (dwResult == WAIT_FAILED)
{
printf("WaitForSingleObject failed\n");
return 1;
}
printf("Thread finished\n");
// 关闭线程句柄
CloseHandle(hThread);
return 0;
}
在该示例中,`CreateThread`函数用于创建一个新的线程。然后,使用`WaitForSingleObject`函数等待线程的结束,直到`WaitForSingleObject`返回成功。最后,关闭线程句柄。
请注意,`WaitForSingleObject`函数有一个参数`dwMilliseconds`,该参数用于指定等待的时间。这里我们使用了`INFINITE`宏来表示无限等待,即一直等待到对象的信号。你也可以设置一个特定的等待时间,例如1000表示等待1秒钟。
亿速云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>
推荐阅读:Delphi中的WaitForSingleObject怎么用