SERVICE_FAILURE_ACTIONSA結構（winsvc.h）

發行項
11/20/2024

表示服務控制器應該針對服務的每個失敗採取的動作。服務在終止時會被視為失敗，而不會向服務控制器回報 SERVICE_STOPPED 狀態。

若要設定要執行失敗動作的其他情況，請參閱 SERVICE_FAILURE_ACTIONS_FLAG。

語法

typedef struct _SERVICE_FAILURE_ACTIONSA {
  DWORD     dwResetPeriod;
  LPSTR     lpRebootMsg;
  LPSTR     lpCommand;
  DWORD     cActions;
  SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONSA, *LPSERVICE_FAILURE_ACTIONSA;

成員

dwResetPeriod

如果沒有任何失敗，則會在幾秒內將失敗計數重設為零的時間。指定 INFINITE，以指出不應該重設此值。

lpRebootMsg

在重新啟動之前，要廣播給伺服器使用者的訊息，以回應 SC_ACTION_REBOOT 服務控制器動作。

如果此值 NULL，則重新啟動訊息不會變更。如果值是空字串（“），則會刪除重新啟動訊息，而且不會廣播任何訊息。

此成員可以使用下列格式來指定本地化的字串：

@[路徑]dllname，-strID

標識子 strID 的字串會從 dllname載入;路徑是選擇性的。如需詳細資訊，請參閱 RegLoadMUIString。

Windows Server 2003 和 Windows XP：在 Windows Vista 之前不支援 當地語系化字串。

lpCommand

CreateProcess 函式要執行的處理程式命令行，以回應 SC_ACTION_RUN_COMMAND 服務控制器動作。此程式會在與服務相同的帳戶下執行。

如果此值 NULL，則命令不會變更。如果值是空字串（“），則會刪除命令，且服務失敗時不會執行任何程式。

cActions

lpsaActions 陣列中的元素數目。

如果此值為 0，但 lpsaActions 不是 NULL，則會刪除重設期間和失敗動作陣列。

lpsaActions

SC_ACTION 結構的陣列指標。

如果此值為 NULL，則會忽略 cActions 和 dwResetPeriod 成員。

言論

服務控制管理員會計算自系統開機後每個服務失敗的次數。如果服務 dwResetPeriod 秒未失敗，計數會重設為 0。當服務第 N次失敗時，服務控制器會執行 lpsaActions 陣列的元素 [N-1] 中指定的動作。如果 N 大於 cActions，服務控制器就會重複數位中的最後一個動作。

注意

winsvc.h 標頭會將 SERVICE_FAILURE_ACTIONS定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winsvc.h （包括 Windows.h）