estrutura REG_RESTORE_KEY_INFORMATION (wdm.h)
A estrutura REG_RESTORE_KEY_INFORMATION contém as informações de uma chave do Registro que está prestes a ser restaurada.
Sintaxe
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;
Membros
Object
Um ponteiro para um objeto de chave do Registro para a chave que está prestes a ser restaurada.
FileHandle
Um identificador para o arquivo do qual o hive será restaurado.
Flags
REG_FORCE_RESTORE
0x00000008L
Se especificada, a operação de restauração será executada mesmo se houver identificadores abertos no local ou abaixo do local na hierarquia do Registro para a qual o parâmetro hKey aponta.
REG_WHOLE_HIVE_VOLATILE
0x00000001L
Se especificado, um novo conjunto volátil (somente memória) de informações do Registro, ou hive, será criado. Se REG_WHOLE_HIVE_VOLATILE for especificado, a chave identificada pelo parâmetro hKey deverá ser o valor HKEY_USERS ou HKEY_LOCAL_MACHINE.
REG_REFRESH_HIVE
0x00000002
Se definido, o local da subárvore para a qual o parâmetro hKey aponta é restaurado para seu estado imediatamente após a última liberação. A subárvore não deve ser liberada lentamente (chamando RegRestoreKey com REG_NO_LAZY_FLUSH especificado como o valor desse parâmetro); o chamador deve ter o privilégio TCB (base de computação confiável) ; e o identificador ao qual o parâmetro hKey se refere deve apontar para a raiz da subárvore.
CallContext
Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
ObjectContext
Um ponteiro para informações de contexto definidas pelo driver, que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
Reserved
Este membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
Comentários
O sinalizador REG_REFRESH_HIVE é opaco e um filtro não deve tentar alterá-lo.
Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas de registro.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Windows Vista SP2 e versões posteriores do sistema operacional Windows. |
Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |