Funzione GetSharedServiceRegistryStateKey (winsvc.h)

  • Articolo

Restituisce un handle per una chiave del Registro di sistema per un servizio e programmi associati a cui leggere e/o scrivere lo stato.

Sintassi

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

Parametri

ServiceHandle

StateType

Membro del SERVICE_SHARED_REGISTRY_STATE_TYPE che specifica il tipo di stato condiviso per cui viene recuperata la chiave del Registro di sistema del servizio.

AccessMask

Maschera di accesso con cui tentare di aprire la chiave di stato. Per altre informazioni, vedere Sicurezza delle chiavi del Registro di sistema e diritti di accesso.

ServiceStateKey

Riceve l'handle della chiave del Registro di sistema di output.

Valore restituito

ERROR_SUCCESS quando tutte le operazioni vengono completate correttamente; in caso contrario, un codice di errore Win32.

Commenti

Per ServiceSharedRegistryStatePersistent, la sicurezza della directory è impostata per fornire solo l'accesso in scrittura all'account di sistema locale, al SID del servizio e agli amministratori locali. Assicurarsi che i SID del servizio siano abilitati per qualsiasi servizio che chiama questa API. Per altre informazioni, vedere SERVICE_SID_INFO.

Per un'API simile che fornisce lo stato del servizio esclusivamente per l'uso dal servizio stesso, vedere GetServiceRegistryStateKey.

Tutte le chiavi del Registro di sistema dello stato del servizio vengono eliminate dalla gestione controllo del servizio dopo la disinstallazione del servizio.

Requisiti

Requisito Valore
Client minimo supportato Windows 11 (Build 22000)
Server minimo supportato Windows Server 2022 (Build 20348)
Intestazione winsvc.h
Libreria Onecore.lib

Vedi anche

Openservice

GetServiceRegistryStateKey

SERVICE_SID_INFO