REG_CREATE_KEY_INFORMATION struttura (wdm.h)

Articolo
03/08/2023

Obsoleta. 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 la routine RegistryCallback di un driver può usare 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;

Members

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 "\" ed è 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 l'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 Class della routine ZwCreateKey .

SecurityDescriptor

Puntatore a una struttura di 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 tenta di creare la chiave del Registro di sistema. Per altre informazioni su questo membro, vedere Osservazioni.

Disposition

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

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 definite dal driver facoltative che la routine RegistryCallback del driver può fornire.

RootObjectContext

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

Transaction

Puntatore a un oggetto transazione su cui viene eseguito il tentativo dell'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 per digitare REG_CREATE_KEY_INFORMATION_V1, che contiene parametri aggiuntivi.

Commenti

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 specificare i valori GrantedAccess, Disposition e ResultObject .

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