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 |