estrutura REG_CREATE_KEY_INFORMATION (wdm.h)

Artigo
02/07/2025

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 de 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 de 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 de ZwCreateKey.

SecurityDescriptor

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

SecurityQualityOfService

Um ponteiro para uma estrutura de 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 Disposição da rotina de 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 definidas pelo driver opcionais que a rotina de registryCallback do driver podem 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 estiver 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.

Observações

O gerenciador de configurações passa essa estrutura para a rotina de 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, Dispositione ResultObject.

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