术语 | cancelwaitabletimer |
释义 | CancelWaitableTimer 语法: C++ BOOL WINAPI CancelWaitableTimer( __in HANDLE hTimer ); CancelWaitableTimer功能 设置可等待定时器指定的非活动状态。 参数 hTimer [in] 一个句柄,计时器对象。在CreateWaitableTimer或OpenWaitableTimer函数返回此句柄。句柄必须有TIMER_MODIFY_STATE访问权限。有关更多信息,请参阅同步对象的安全和访问权限。 返回值 如果函数成功,返回值为非零。 如果函数失败,返回值是零。为了获得更多错误信息,调用GetLastError。 备注 该CancelWaitableTimer函数不改变定时器的信号状态。它停止之前可以设置为信号状态,并取消优秀装甲运兵车计时器。因此,线程计时器上执行等待操作继续等待,直到他们超时或计时器重新激活,其状态设置为信号。如果计时器已经在信号状态,但仍然在该州。 要重新启动计时器,调用SetWaitableTimer功能。 要编译的应用程序使用此功能,定义_WIN32_WINNT为0x0400或更高版本。有关详细信息,请参阅使用Windows头。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderWinbase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 CreateWaitableTimer OpenWaitableTimer SetWaitableTimer 同步功能 可等待定时器对象 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年8月27日 ==英文原文==CancelWaitableTimer Function Sets the specified waitable timer to the inactive state. Syntax C++ BOOL WINAPI CancelWaitableTimer( __in HANDLE hTimer ); Parameters hTimer [in] A handle to the timer object. The CreateWaitableTimer or OpenWaitableTimer function returns this handle. The handle must have the TIMER_MODIFY_STATE access right. For more information, see Synchronization Object Security and Access Rights . Return Value If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError . Remarks The CancelWaitableTimer function does not change the signaled state of the timer. It stops the timer before it can be set to the signaled state and cancels outstanding APCs. Therefore, threads performing a wait operation on the timer remain waiting until they time out or the timer is reactivated and its state is set to signaled. If the timer is already in the signaled state, it remains in that state. To reactivate the timer, call the SetWaitableTimer function. To compile an application that uses this function, define _WIN32_WINNT as 0x0400 or later. For more information, see Using the Windows Headers . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also CreateWaitableTimer OpenWaitableTimer SetWaitableTimer Synchronization Functions Waitable Timer Objects Send comments about this topic to Microsoft Build date: 8/27/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/ms681985(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。