GetServiceRegistryStateKey 함수(winsvc.h)

서비스가 상태를 읽고/또는 쓸 수 있도록 레지스트리 키에 대한 핸들을 반환합니다.

구문

DWORD GetServiceRegistryStateKey(
  SERVICE_STATUS_HANDLE       ServiceStatusHandle,
  SERVICE_REGISTRY_STATE_TYPE StateType,
  DWORD                       AccessMask,
  HKEY                        *ServiceStateKey
);

매개 변수

ServiceStatusHandle

현재 서비스의 상태 정보 구조에 대한 핸들입니다. 이 핸들은 RegisterServiceCtrlHandler 함수에 의해 반환됩니다.

StateType

서비스 레지스트리 키가 다시 처리되는 상태 유형을 지정하는 SERVICE_REGISTRY_STATE_TYPE 멤버입니다.

AccessMask

상태 키를 열려고 시도하는 액세스 마스크입니다. 자세한 내용은 레지스트리 키 보안 및 액세스 권한을 참조하세요.

ServiceStateKey

출력 레지스트리 키 핸들을 받습니다.

반환 값

모든 작업이 성공적으로 완료되면 ERROR_SUCCESS. 그렇지 않으면 Win32 오류 코드입니다.

설명

ServiceRegistryStatePersistent의 경우 디렉터리의 보안은 로컬 시스템 계정 및 서비스 SID에 대한 쓰기 액세스만 제공하도록 설정됩니다. 이 API를 호출하는 모든 서비스에 대해 서비스 SID가 사용하도록 설정되어 있는지 확인합니다. 자세한 내용은 SERVICE_SID_INFO 참조하세요.

연결된 프로그램과 공유할 수 있는 서비스 상태를 제공하는 유사한 API는 GetSharedServiceRegistryStateKey를 참조하세요.

서비스가 제거되면 서비스 제어 관리자가 모든 서비스 상태 레지스트리 키를 삭제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 2004(10.0; 빌드 19041)
지원되는 최소 서버	Windows Server 버전 2004(10.0; 빌드 19041)
머리글	winsvc.h
라이브러리	Onecore.lib

추가 정보

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO