struttura REG_RESTORE_KEY_INFORMATION (wdm.h)

Articolo
02/07/2025

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;

Membri

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 la posizione 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 volatile (solo memoria) o hive. Se si specifica 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 ripristinato immediatamente dopo l'ultimo scaricamento. Il sottoalbero non deve essere scaricato lazy (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 di contesto facoltative definite dal driver che il driver RegistryCallback routine può fornire. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

ObjectContext

Puntatore alle informazioni sul contesto definite dal driver associate 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 un uso futuro. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

Osservazioni

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 del Registro di sistema.

Fabbisogno

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)

Vedere anche

CmSetCallbackObjectContext

RegistryCallback

Condividi tramite