InitiateSystemShutdown

【勇芳软件工作室】汉化HomePreviousNext

InitiateSystemShutdown功能启动指定计算机的关机和可选重新启动。

BOOL InitiateSystemShutdown(

LPTSTR 【lpMachineName】,//关闭计算机名称的地址
LPTSTR 【// address of message to display in dialog box】,//在对话框中显示的消息的地址
DWORD 【dwTimeout】,//显示时间对话框
BOOL 【bForceAppsClosed】,//强制应用程序带有未保存的更改标志
BOOL 【bRebootAfterShutdown】Points to the null-terminated string that specifies the network name of the computer to shut down.
); 

参数

【lpMachineName】

指向以空值终止的字符串,指定要关闭的计算机的网络名称。如果【lpMachineName】为NULL或指向空字符串,该函数将关闭本地计算机。

【// address of message to display in dialog box】

指向一个以null结尾的字符串,指定在关机对话框中显示的消息。如果不需要消息,该参数可以为NULL。

【dwTimeout】

指定对话框应显示的时间(以秒为单位)。显示此对话框时,AbortSystemShutdown功能可以停止关机。

如果【dwTimeout】不为零,InitiateSystemShutdown将在指定的计算机上显示一个对话框。对话框显示调用该函数的用户的名称,显示【// address of message to display in dialog box】参数指定的消息,并提示用户注销。对话框在创建时会发出哔声,并保留在系统中其他窗口的顶部。对话框可以移动但未关闭。一个定时器会在强制关机前对剩余时间进行计数。如果用户注销,系统将立即关闭。否则,当计时器到期时,计算机将关闭。

如果【dwTimeout】为零,计算机将关闭而不显示该对话框,并且AbortSystemShutdown无法停止关机。

【bForceAppsClosed】

指定是否强制关闭具有未保存更改的应用程序。如果此参数为TRUE,则此类应用程序将关闭。如果此参数为FALSE,将显示一个对话框,提示用户关闭应用程序。

【bRebootAfterShutdown】

指定计算机是否在关闭后立即重新启动。如果此参数为TRUE,则计算机将重新启动。如果此参数为FALSE,系统将所有缓存刷新到磁盘,清除屏幕,并显示一条消息,指示可以安全关闭电源。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

要关闭本地计算机,调用进程必须具有SE_SHUTDOWN_NAME特权。要关闭远程计算机,调用进程必须在远程计算机上具有SE_REMOTE_SHUTDOWN_NAME权限。默认情况下,用户可以在登录的计算机上启用SE_SHUTDOWN_NAME权限,管理员可以在远程计算机上启用SE_REMOTE_SHUTDOWN_NAME权限。

常见故障包括无效或无法访问的计算机名称或权限不足。

也可以看看

AbortSystemShutdown