阅读量:0
在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秒钟。