请输入您要查询的百科知识:

 

词条 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条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2025/2/7 18:26:00