AbortSystemShutdownW 函式 (winreg.h)
停止已起始的系統關機。
語法
BOOL AbortSystemShutdownW(
[in, optional] LPWSTR 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 標頭會根據 UNICODE 預處理器常數的定義,將 AbortSystemShutdown 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | winreg.h (包括 Windows.h) |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |