GetSharedServiceRegistryStateKey, fonction (winsvc.h)

Retourne un handle pour une clé de Registre pour un service et les programmes associés à lire et/ou écrire l’état.

Syntaxe

DWORD GetSharedServiceRegistryStateKey(
  SC_HANDLE                          ServiceHandle,
  SERVICE_SHARED_REGISTRY_STATE_TYPE StateType,
  DWORD                              AccessMask,
  HKEY                               *ServiceStateKey
);

Paramètres

ServiceHandle

StateType

Un membre du SERVICE_SHARED_REGISTRY_STATE_TYPE spécifiant le type d’état partagé pour lequel la clé de Registre de services est récupérée.

AccessMask

Masque d’accès avec lequel tenter d’ouvrir la clé d’état. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.

ServiceStateKey

Reçoit le handle de clé de Registre de sortie.

Valeur retournée

ERROR_SUCCESS lorsque toutes les opérations se terminent correctement ; sinon, un code d’erreur Win32.

Remarques

Pour ServiceSharedRegistryStatePersistent, la sécurité de l’annuaire est définie pour fournir uniquement un accès en écriture au compte système local, au SID de service et aux administrateurs locaux. Vérifiez que les SID de service sont activés pour tout service qui appelle cette API. Pour plus d’informations, consultez SERVICE_SID_INFO.

Pour une API similaire qui fournit l’état du service exclusivement pour une utilisation par le service lui-même, consultez GetServiceRegistryStateKey.

Toutes les clés de Registre d’état du service sont supprimées par le gestionnaire de contrôle de service une fois le service désinstallé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11 (build 22000)
Serveur minimal pris en charge	Windows Server 2022 (build 20348)
En-tête	winsvc.h
Bibliothèque	Onecore.lib

Voir aussi

OpenService

GetServiceRegistryStateKey

SERVICE_SID_INFO