词条 | InitiateSystemShutdown |
释义 | InitiateSystemShutdown: BOOL InitiateSystemShutdown(lpszMachineName,lpszMessage,dwTimeout,fForce App sClosed,fReboot) 说明:InitiateSystemShutdown函数激活指定的一次关机和重启动。 参数:lpszMachineName 指定以MULL终止的用来指定要关机的网络名称的字符串。如果lpszMachineName为NULL, 或指向一个空串,则该函数关掉本地计算机。 LpszMessage 指向一个以MULL终止的指定要显示在关机对话框中的消息的字符串。如果不需要消息, 该参数可以为NULL。 DwTimeout 指定对话框应该显示的时间(按秒计)。在此对话框显示期间,可通过调用AbortSyste mShutdown函数将关机停止。 如果DwTimeout不为零,则InitiateSystemShutdown在指定的计算机上显示的一个对 话框。该对话框显示调用此函数的用户名,显示由lpszMessage参数指定的消息,并提示 用户退出系统。当对话框被创建时发出嘟嘟声,并保持位于系统中其它窗口的上面。此 对话框可以被移动,但不能被关闭。定时器倒记在强制关机之前剩余的时间。如果用户 退出系统,系统立即关闭。否则,当定时器到时间计算机才关机。 如果DwTimeout为零时,计算机关机,但不显示此对话框,并且不能用AbortSystem Shutdown函数来停止关机。 fForce AppsClosed 指定对变化未做保存的应用程序是否被强制关闭。如果这个参数为TRUE,则这样的 应用程序被关闭。如果这个参数为FALSE,则显示一个对话框以提示用户关闭这些应用程 序。 FReboot 指定计算机关机之后是否立即重启。如果这个参数为TRUE,则计算机重启。如果这 个参数为FALSE,则系统将所有高速缓存刷新到磁盘上,清除屏幕,并且显示一条消息, 指示关掉电源是安全的。 返回值:如果函数成功,则返回值为TRUE;否则,返回值为FALSE。要获得扩展错误信息 ,可使用GetLastError函数。 注释:要关掉本地计算机,调用进程必须具有SE_SHUTDOWN_NAME特权。要关掉一台远程 计算机,调用进程必须对此远程计算机具有的SE_REMOTE_SHUTDOWN_NAME特权。缺省情况 下,用户具有对他们所有登录计算机的SE_SHUTDOWN_NAME特权,管理员具有对远程计算 机的SE_REMOTE_SHUTDOWN_NAME特权。 例子: HANDLE hToken; TOKEN_PRIVILEGES tkp; //得到进程权标 if (!OpenProcessToken(GetCurrentProcess(),TOKEN_ADJUST_PRIVILEGES && TOKEN_QUERY,&hToken)) return; //得到关机的特权的LUID LookupPrivilegeValue(NULL,SE_SHUTDOWN_NAME,&tkp.Privileges[0].Luid); tkp.PrivilegeCount = 1;//设置一个特权 tkp.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED; //得到进程关机的特权 AdjustTokenPrivileges(hToken, FALSE, &tkp, 0, (PTOKEN_PRIVILEGES)NULL, 0); ::InitiateSystemShutdown(NULL,"关机进行中!",100,true,true); |
随便看 |
百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。