AbortSystemShutdownA 函式 (winreg.h)
停止已起始的系統關機。
語法
BOOL AbortSystemShutdownA(
[in, optional] LPSTR lpMachineName
);
參數
[in, optional] lpMachineName
要停止關機的計算機網路名稱。 如果 lpMachineNameNULL 或空字串,則函式會停止本機電腦上的關機。
傳回值
如果函式成功,則傳回值為非零值。
如果函式失敗,傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
言論
InitiateSystemShutdown 和 InitiateSystemShutdownEx 函式會顯示對話框,通知用戶系統正在關閉。 在關機逾時期間,AbortSystemShutdown 函式可防止系統關閉。
Windows Server 2003 和 Windows XP SP1:如果要關閉的電腦是終端機服務伺服器,系統會向所有本機和遠端使用者顯示對話框,警告其已啟動關機。 如果 AbortSystemShutdown防止關機,系統會向使用者顯示對話方塊,告知他們伺服器不再關閉。
若要停止本機電腦關閉,呼叫進程必須具有SE_SHUTDOWN_NAME許可權。 若要停止遠端電腦關閉,呼叫進程必須在遠端電腦上具有SE_REMOTE_SHUTDOWN_NAME許可權。 根據預設,用戶可以在登入的計算機上啟用SE_SHUTDOWN_NAME許可權,而系統管理員可以在遠端電腦上啟用SE_REMOTE_SHUTDOWN_NAME許可權。 如需詳細資訊,請參閱 以特殊許可權執行。
失敗的常見原因包括無效的計算機名稱、無法存取的計算機或許可權不足。
例子
如需範例,請參閱 顯示關機對話框。
注意
winreg.h 標頭會根據 UNICODE 預處理器常數的定義,將 AbortSystemShutdown 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
支援的最低伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平臺 | 窗戶 |
標頭 | winreg.h (包括 Windows.h) |
連結庫 | Advapi32.lib |
DLL | Advapi32.dll |