GetServiceRegistryStateKey, fonction (winsvc.h)

Retourne un handle pour une clé de Registre dans laquelle un service doit lire et/ou écrire l’état.

Syntaxe

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

Paramètres

ServiceStatusHandle

Handle de la structure d’informations status pour le service actuel. Ce handle est retourné par la fonction RegisterServiceCtrlHandler .

StateType

Un membre du SERVICE_REGISTRY_STATE_TYPE spécifiant le type d’état pour lequel la clé de Registre de service est retreive.

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 ServiceRegistryStatePersistent, la sécurité de l’annuaire est définie pour fournir uniquement l’accès en écriture au compte système local et au SID de service. 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 qui peut être partagé avec les programmes associés, consultez GetSharedServiceRegistryStateKey.

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 10, version 2004 (10.0 ; Build 19041)
Serveur minimal pris en charge	Windows Server, version 2004 (10.0 ; Build 19041)
En-tête	winsvc.h
Bibliothèque	Onecore.lib

Voir aussi

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO