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 액세스 권한을 획득할 수 있는 권한이 있어야 합니다. 자세한 내용은 서비스 보안 및 액세스 권한을 참조하세요.