notifyBootConfigStatus 函式 (winsvc.h)

向服務控制管理員報告開機狀態。它由開機驗證程式使用。此函式只能由在 LocalSystem 或系統管理員帳戶中執行的進程呼叫。

語法

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

[in] BootAcceptable

如果值為 TRUE，系統會將設定儲存為最後已知良好的組態。如果值為 FALSE，系統會使用先前儲存的最後已知良好設定，立即重新開機系統。

如果 BootAcceptable 參數為 FALSE，則函式不會傳回。

如果成功儲存最後一個已知的良好組態，傳回值為非零值。

如果發生錯誤，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

服務控制管理員可能會設定下列錯誤碼。其他錯誤碼可由服務控制管理員呼叫的登錄函式設定，以在組態登錄中設定參數。

傳回碼	描述
ERROR_ACCESS_DENIED	使用者沒有執行這項作業的權限。只有系統管理員群組的系統與成員才能這麼做。

使用此函式儲存執行中系統的組態是儲存最後已知良好設定的可接受方法。如果無法接受開機設定，請使用此函式，使用現有的上次已知良好組態重新開機系統。

此函式呼叫需要呼叫端的權杖，才能取得SC_MANAGER_MODIFY_BOOT_CONFIG存取權限。如需詳細資訊，請參閱服務安全性和存取權限。