Condividi tramite


Funzione GetServiceRegistryStateKey (winsvc.h)

Restituisce un handle per una chiave del Registro di sistema in cui un servizio legge e/o scrive lo stato.

Sintassi

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

Parametri

ServiceStatusHandle

Handle per la struttura delle informazioni sullo stato per il servizio corrente. Questo handle viene restituito dalla funzione RegisterServiceCtrlHandler .

StateType

Membro del SERVICE_REGISTRY_STATE_TYPE che specifica il tipo di stato per il quale la chiave del Registro di sistema del servizio viene retreived.

AccessMask

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

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 ServiceRegistryStatePersistent, la sicurezza della directory è impostata per fornire solo l'accesso in scrittura all'account di sistema locale e al SID del servizio. 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 che può essere condiviso con i programmi associati, vedere GetSharedServiceRegistryStateKey.

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 10 versione 2004 (10.0; Build 19041)
Server minimo supportato Windows Server, versione 2004 (10.0; Build 19041)
Intestazione winsvc.h
Libreria Onecore.lib

Vedi anche

RegisterServiceCtrlHandler

GetSharedServiceRegistryStateKey

SERVICE_SID_INFO