2024年3月14日发(作者：)
waitforsingleobject用法
WaitForSingleObject是Windows API中的一个函数，用于等待一
个对象的信号状态。在多线程编程中，它是非常重要的一个函数，可
以用来同步线程的执行顺序，避免竞争条件的发生。
WaitForSingleObject的用法非常简单，它只有两个参数：要等待的
对象句柄和等待的时间。对象句柄可以是一个线程句柄、进程句柄、
事件句柄、互斥体句柄、信号量句柄等等。等待的时间可以是一个固
定的时间，也可以是一个无限等待。
当WaitForSingleObject函数被调用时，它会阻塞当前线程的执行，
直到等待的对象被信号激活或者等待时间到达。如果等待的对象已经
被信号激活，那么函数会立即返回WAIT_OBJECT_0，表示等待成功。
如果等待的时间到达，但是等待的对象还没有被信号激活，那么函数
会返回WAIT_TIMEOUT，表示等待超时。如果等待的对象句柄无效，
那么函数会返回WAIT_FAILED，表示等待失败。
下面是一个简单的例子，演示了如何使用WaitForSingleObject函数
等待一个线程的结束：
```c++
#include
#include
DWORD WINAPI ThreadProc(LPVOID lpParam)
{
std::cout << "Thread " << std::endl;
Sleep(5000);
std::cout << "Thread " << std::endl;
return 0;
}
int main()
{
HANDLE hThread = CreateThread(NULL, 0, ThreadProc, NULL,
0, NULL);
if (hThread == NULL)
{
std::cerr << "Failed to create thread!" << std::endl;
return 1;
}
DWORD dwResult = WaitForSingleObject(hThread, INFINITE);
if (dwResult == WAIT_OBJECT_0)
{
std::cout << "Thread is exited!" << std::endl;
}
else if (dwResult == WAIT_TIMEOUT)
{
std::cerr << "Wait for thread timeout!" << std::endl;
}
else if (dwResult == WAIT_FAILED)
{
std::cerr << "Wait for thread failed!" << std::endl;
}
CloseHandle(hThread);
return 0;
}
```
在这个例子中，我们创建了一个线程，并使用WaitForSingleObject
函数等待它的结束。由于我们使用了INFINITE作为等待时间，所以函
数会一直等待，直到线程结束。当线程结束时，函数会返回
WAIT_OBJECT_0，我们就可以知道线程已经结束了。
总结一下，WaitForSingleObject是一个非常重要的函数，它可以用
来同步线程的执行顺序，避免竞争条件的发生。在使用它时，我们需
要注意等待的对象句柄和等待的时间，以及函数返回的结果。如果我
们使用得当，它可以帮助我们写出更加健壮和可靠的多线程程序。
发布评论