struttura REG_RESTORE_KEY_INFORMATION (wdm.h)

  • Articolo

La struttura REG_RESTORE_KEY_INFORMATION contiene le informazioni per una chiave del Registro di sistema che sta per essere ripristinata.

Sintassi

typedef struct _REG_RESTORE_KEY_INFORMATION {
  PVOID  Object;
  HANDLE FileHandle;
  ULONG  Flags;
  PVOID  CallContext;
  PVOID  ObjectContext;
  PVOID  Reserved;
} REG_RESTORE_KEY_INFORMATION, *PREG_RESTORE_KEY_INFORMATION;

Members

Object

Puntatore a un oggetto chiave del Registro di sistema per la chiave che sta per essere ripristinata.

FileHandle

Handle per il file da cui verrà ripristinato l'hive.

Flags

REG_FORCE_RESTORE

0x00000008L

Se specificato, l'operazione di ripristino viene eseguita anche se esistono handle aperti in corrispondenza o sotto il percorso nella gerarchia del Registro di sistema a cui punta il parametro hKey .

REG_WHOLE_HIVE_VOLATILE

0x00000001L

Se specificato, viene creato un nuovo set di informazioni del Registro di sistema (solo memoria) volatile o hive. Se viene specificato REG_WHOLE_HIVE_VOLATILE, la chiave identificata dal parametro hKey deve essere il valore HKEY_USERS o HKEY_LOCAL_MACHINE.

REG_REFRESH_HIVE

0x00000002

Se impostato, la posizione del sottoalbero a cui punta il parametro hKey viene ripristinata immediatamente dopo l'ultimo scaricamento. Il sottoalbero non deve essere scaricato differita (chiamando RegRestoreKey con REG_NO_LAZY_FLUSH specificato come valore di questo parametro); il chiamante deve avere il privilegio TCB (Trusted Computing Base); e l'handle a cui fa riferimento il parametro hKey deve puntare alla radice del sottoalbero.

CallContext

Informazioni sul contesto facoltative definite dal driver che la routine RegistryCallback del driver può fornire. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

ObjectContext

Puntatore alle informazioni sul contesto definite dal driver, che il driver ha associato a un oggetto del Registro di sistema chiamando CmSetCallbackObjectContext. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

Reserved

Questo membro è riservato per usi futuri. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

Commenti

Il flag REG_REFRESH_HIVE è opaco e un filtro non deve tentare di modificarlo.

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

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista SP2 e versioni successive del sistema operativo Windows.
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Vedi anche

CmSetCallbackObjectContext

RegistryCallback