estrutura REG_CREATE_KEY_INFORMATION (wdm.h)

Artigo
03/08/2023

Obsoleto. A partir do Windows 7, use REG_CREATE_KEY_INFORMATION_V1, a versão V1 dessa estrutura.

A estrutura REG_CREATE_KEY_INFORMATION contém informações que a rotina RegistryCallback de um driver pode usar quando uma chave do Registro está sendo criada.

Sintaxe

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;

Membros

CompleteName

Um ponteiro para uma estrutura UNICODE_STRING que contém o caminho da nova chave do Registro. O caminho pode ser absoluto ou relativo. Se o caminho for absoluto, essa estrutura conterá um caminho totalmente qualificado que começa com o caractere "\". Para um caminho absoluto, o membro RootObject especifica a chave \REGISTRY , que é o diretório raiz da árvore do Registro. Se o caminho for relativo, o caminho começará com um caractere diferente de "\" e será relativo à chave especificada pelo membro RootObject .

RootObject

Ponteiro para o objeto de chave do Registro que serve como a raiz do caminho especificado pelo membro CompleteName .

ObjectType

O membro ObjectType é reservado para uso interno. Os drivers não devem acessar esse membro.

CreateOptions

Um OR bit a bit de sinalizadores. Para obter mais informações sobre esses sinalizadores, consulte o parâmetro CreateOptions da rotina ZwCreateKey .

Class

Um ponteiro para uma estrutura UNICODE_STRING que identifica a classe de objeto da chave. Para obter mais informações sobre esse membro, consulte o parâmetro Class da rotina ZwCreateKey .

SecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que contém informações de segurança para o objeto de chave.

SecurityQualityOfService

Um ponteiro para uma estrutura SECURITY_QUALITY_OF_SERVICE , que é definida em Winnt.h.

DesiredAccess

A máscara de acesso especificada pelo thread que está tentando criar a chave do Registro.

GrantedAccess

Uma máscara de acesso que indica os direitos de acesso que foram concedidos ao thread que está tentando criar a chave do Registro. Para obter mais informações sobre esse membro, consulte Comentários.

Disposition

Um valor que indica se a chave do Registro foi criada. Para obter mais informações sobre esse membro, consulte o parâmetro Disposition da rotina ZwCreateKey e a seção Comentários a seguir.

ResultObject

Um ponteiro para um local que recebe o endereço do objeto de chave que representa a chave do Registro criada. Para obter mais informações sobre esse membro, consulte Comentários.

CallContext

Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer.

RootObjectContext

Um ponteiro para informações de contexto definidas pelo driver que o driver associou à raiz do caminho do objeto do Registro chamando CmSetCallbackObjectContext.

Transaction

Um ponteiro para um objeto de transação no qual a operação é tentada. Se esse membro for NULL, a operação será executada em contexto não transacional.

Reserved

Se esse membro for 1, será seguro converter essa estrutura para digitar REG_CREATE_KEY_INFORMATION_V1, que contém parâmetros adicionais.

Comentários

O gerenciador de configurações passa essa estrutura para a rotina RegistryCallback sempre que um thread tenta criar uma chave, por exemplo, quando um thread no modo de usuário chama RegCreateKey ou RegCreateKeyEx ou quando um driver chama ZwCreateKey.

Se a rotina RegistryCallback do driver retornar STATUS_CALLBACK_BYPASS para uma notificação RegNtPreCreateKeyEx , o driver deverá fornecer os valores GrantedAccess, Disposition e ResultObject .

Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas do Registro.