GetSharedServiceRegistryStateKey-Funktion (winsvc.h)

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

Syntax

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

Parameter

ServiceHandle

StateType

Ein Member der SERVICE_SHARED_REGISTRY_STATE_TYPE , der den freigegebenen Zustandstyp angibt, für den der Dienstregistrierungsschlüssel abgerufen 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 ServiceSharedRegistryStatePersistent ist die Sicherheit des Verzeichnisses so festgelegt, dass nur Schreibzugriff auf das lokale Systemkonto, die Dienst-SID und lokale Administratoren gewährt 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 ausschließlich zur Verwendung durch den Dienst selbst bereitstellt, finden Sie unter GetServiceRegistryStateKey.

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

Anforderungen

Weitere Informationen

Openservice

GetServiceRegistryStateKey

SERVICE_SID_INFO