NotifyBootConfigStatus 関数 (winsvc.h)

ブート状態をサービスコントロールマネージャーに報告します。これは、ブート検証プログラムによって使用されます。この関数は、LocalSystem または管理者のアカウントで実行されているプロセスによってのみ呼び出すことができます。

構文

BOOL NotifyBootConfigStatus(
  [in] BOOL BootAcceptable
);

[in] BootAcceptable

値が TRUE の場合、システムは構成を最後に既知の適切な構成として保存します。値が FALSE の場合は、以前に保存した最後に既知の正常な構成を使用して、システムが直ちに再起動します。

BootAcceptable パラメーターが FALSE の場合、関数はを返しません。

最後に既知の正常な構成が正常に保存された場合、戻り値は 0 以外です。

エラーが発生した場合、戻り値は 0 になります。詳細なエラー情報を得るには、GetLastError を呼び出します。

サービスコントロールマネージャーによって、次のエラーコードが設定される場合があります。その他のエラーコードは、構成レジストリのパラメーターを設定するためにサービスコントロールマネージャーによって呼び出されるレジストリ関数によって設定される場合があります。

リターンコード	説明
ERROR_ACCESS_DENIED	この操作を実行する権限がユーザーにありません。管理者のグループのシステムとメンバーのみがこれを行うことができます。

この関数を使用して実行中のシステムの構成を保存することは、最後に既知の正常な構成を保存するための許容される方法です。ブート構成が受け入れられない場合は、この関数を使用して、既存の最後に既知の正常な構成を使用してシステムを再起動します。

この関数呼び出しでは、呼び出し元のトークンに、SC_MANAGER_MODIFY_BOOT_CONFIGアクセス権を取得するアクセス許可が必要です。詳細については、「サービスセキュリティとアクセス権」を参照してください。