InitiateSystemShutdown与AbortSystemShutdown

来源:互联网 发布:云计算运维好找工作吗 编辑:程序博客网 时间:2024/06/07 11:29

                  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);

AbortSystemShutdown用于取消关机和重启。

原创粉丝点击