estrutura REG_RESTORE_KEY_INFORMATION (wdm.h)

  • Artigo

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)

Confira também

CmSetCallbackObjectContext

RegistryCallback