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

另请参阅

OpenService

GetServiceRegistryStateKey

SERVICE_SID_INFO