GetServiceRegistryStateKey-Funktion (winsvc.h)

Gibt ein Handle für einen Registrierungsschlüssel für einen Dienst zurück, in den der Zustand gelesen und/oder geschrieben werden soll.

Syntax

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

Parameter

ServiceStatusHandle

Ein Handle für die status Informationsstruktur für den aktuellen Dienst. Dieses Handle wird von der RegisterServiceCtrlHandler-Funktion zurückgegeben.

StateType

Ein Member der SERVICE_REGISTRY_STATE_TYPE , der den Zustandstyp angibt, für den der Dienstregistrierungsschlüssel erneut verwendet wird.

AccessMask

Die Zugriffsmaske, mit der versucht werden soll, den Zustandsschlüssel zu öffnen. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

ServiceStateKey

Empfängt das Handle des Ausgaberegistrierungsschlüssels.

Rückgabewert

ERROR_SUCCESS, wenn alle Vorgänge erfolgreich abgeschlossen wurden; andernfalls ein Win32-Fehlercode.

Hinweise

Für ServiceRegistryStatePersistent ist die Sicherheit des Verzeichnisses so festgelegt, dass nur Schreibzugriff auf das lokale Systemkonto und die Dienst-SID bereitgestellt wird. Stellen Sie sicher, dass Dienst-SIDs für jeden Dienst aktiviert sind, der diese API aufruft. Weitere Informationen finden Sie unter SERVICE_SID_INFO.

Eine ähnliche API, die den Dienststatus bereitstellt, der für zugeordnete Programme freigegeben werden kann, finden Sie unter GetSharedServiceRegistryStateKey.

Alle Registrierungsschlüssel für den Dienststatus werden vom Dienststeuerungs-Manager gelöscht, sobald der Dienst deinstalliert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server)	Windows Server, Version 2004 (10.0; Build 19041)
Kopfzeile	winsvc.h
Bibliothek	Onecore.lib

Weitere Informationen

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO