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 |