GetSharedServiceRegistryStateKey 函数 (winsvc.h)
返回服务的注册表项的句柄,以及要读取和/或写入状态的关联程序。
语法
DWORD GetSharedServiceRegistryStateKey(
SC_HANDLE ServiceHandle,
SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
DWORD AccessMask,
HKEY *ServiceStateKey
);
参数
ServiceHandle
StateType
SERVICE_SHARED_REGISTRY_STATE_TYPE的成员,指定检索服务注册表项的共享状态类型。
AccessMask
用于尝试打开状态密钥的访问掩码。 有关详细信息,请参阅 注册表项安全和访问权限。
ServiceStateKey
接收输出注册表项句柄。
返回值
当所有操作成功完成时ERROR_SUCCESS;否则为 Win32 错误代码。
注解
对于 ServiceSharedRegistryStatePersistent,目录的安全性设置为仅提供对本地系统帐户、服务 SID 和本地管理员的写入访问权限。 确保为调用此 API 的任何服务启用服务 SID。 有关详细信息,请参阅 SERVICE_SID_INFO。
有关专门提供服务状态以供服务本身使用的类似 API,请参阅 GetServiceRegistryStateKey。
卸载服务后,服务控制管理器会删除所有服务状态注册表项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 11 (内部版本 22000) |
最低受支持的服务器 | Windows Server 2022 (内部版本 20348) |
标头 | winsvc.h |
Library | Onecore.lib |