estrutura REG_CREATE_KEY_INFORMATION (wdm.h)
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.
Requisitos
Requisito | Valor |
---|---|
cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |