正文
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_PRIVILEGEStkp;
//得到进程权标
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);