AbortSystemShutdownA 函式 (winreg.h)

停止已起始的系統關機。

語法

BOOL AbortSystemShutdownA(
  [in, optional] LPSTR lpMachineName
);

參數

[in, optional] lpMachineName

要停止關機的計算機網路名稱。 如果 lpMachineName 為 NULL 或空字串，則函式會停止本機電腦上的關機。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 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 標頭會將 AbortSystemShutdown 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	winreg.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll

另請參閱

InitiateSystemShutdown

關閉

系統關機函式