struttura REG_CREATE_KEY_INFORMATION (wdm.h)

Articolo
02/07/2025

Obsoleto. A partire da Windows 7, usare REG_CREATE_KEY_INFORMATION_V1, la versione V1 di questa struttura.

La struttura REG_CREATE_KEY_INFORMATION contiene informazioni che è possibile utilizzare routine RegistryCallback di un driver quando viene creata una chiave del Registro di sistema.

Sintassi

typedef struct _REG_CREATE_KEY_INFORMATION {
  PUNICODE_STRING CompleteName;
  PVOID           RootObject;
  PVOID           ObjectType;
  ULONG           CreateOptions;
  PUNICODE_STRING Class;
  PVOID           SecurityDescriptor;
  PVOID           SecurityQualityOfService;
  ACCESS_MASK     DesiredAccess;
  ACCESS_MASK     GrantedAccess;
  PULONG          Disposition;
  PVOID           *ResultObject;
  PVOID           CallContext;
  PVOID           RootObjectContext;
  PVOID           Transaction;
  PVOID           Reserved;
} REG_CREATE_KEY_INFORMATION, REG_OPEN_KEY_INFORMATION, *PREG_CREATE_KEY_INFORMATION, *PREG_OPEN_KEY_INFORMATION;

Membri

CompleteName

Puntatore a una struttura UNICODE_STRING che contiene il percorso della nuova chiave del Registro di sistema. Il percorso può essere assoluto o relativo. Se il percorso è assoluto, questa struttura contiene un percorso completo che inizia con il carattere "\". Per un percorso assoluto, il membro RootObject specifica la chiave \REGISTRY, ovvero la directory radice dell'albero del Registro di sistema. Se il percorso è relativo, il percorso inizia con un carattere diverso da "\" e è relativo alla chiave specificata dal membro RootObject.

RootObject

Puntatore all'oggetto chiave del Registro di sistema che funge da radice per il percorso specificato dal membro CompleteName.

ObjectType

Il membro ObjectType è riservato per uso interno. I driver non devono accedere a questo membro.

CreateOptions

OR bit per bit dei flag. Per altre informazioni su questi flag, vedere il parametro CreateOptions della routine ZwCreateKey.

Class

Puntatore a una struttura UNICODE_STRING che identifica la classe oggetto della chiave. Per altre informazioni su questo membro, vedere il parametro classe della routine ZwCreateKey.

SecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR che contiene informazioni di sicurezza per l'oggetto chiave.

SecurityQualityOfService

Puntatore a una struttura SECURITY_QUALITY_OF_SERVICE, definita in Winnt.h.

DesiredAccess

Maschera di accesso specificata dal thread che tenta di creare la chiave del Registro di sistema.

GrantedAccess

Maschera di accesso che indica i diritti di accesso concessi al thread che sta tentando di creare la chiave del Registro di sistema. Per altre informazioni su questo membro, vedere Osservazioni.

Disposition

Valore che indica se la chiave del Registro di sistema è stata creata. Per altre informazioni su questo membro, vedere il parametro Disposition della routine ZwCreateKey e la sezione Osservazioni seguente.

ResultObject

Puntatore a una posizione che riceve l'indirizzo dell'oggetto chiave che rappresenta la chiave del Registro di sistema creata. Per altre informazioni su questo membro, vedere Osservazioni.

CallContext

Informazioni di contesto facoltative definite dal driver che il driver RegistryCallback routine può fornire.

RootObjectContext

Puntatore a informazioni sul contesto definite dal driver associate al driver alla radice del percorso dell'oggetto del Registro di sistema chiamando CmSetCallbackObjectContext.

Transaction

Puntatore a un oggetto transazione su cui viene tentata l'operazione. Se questo membro è NULL, l'operazione viene eseguita nel contesto non transazionale.

Reserved

Se questo membro è 1, è possibile eseguire il cast di questa struttura al tipo REG_CREATE_KEY_INFORMATION_V1, che contiene parametri aggiuntivi.

Osservazioni

Gestione configurazione passa questa struttura alla routine RegistryCallback ogni volta che un thread tenta di creare una chiave, ad esempio quando un thread in modalità utente chiama RegCreateKey o RegCreateKeyEx o quando un driver chiama ZwCreateKey.

Se la routine RegistryCallback del driver restituisce STATUS_CALLBACK_BYPASS per una notifica RegNtPreCreateKeyEx, il driver deve fornire i valori GrantedAccess Dispositione ResultObject.

Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.