structure REG_CREATE_KEY_INFORMATION (wdm.h)

Article
02/27/2024

Obsolète. À partir de Windows 7, utilisez plutôt REG_CREATE_KEY_INFORMATION_V1, la version V1 de cette structure.

La structure REG_CREATE_KEY_INFORMATION contient des informations que la routine RegistryCallback d’un pilote peut utiliser lors de la création d’une clé de Registre.

Syntaxe

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;

Membres

CompleteName

Pointeur vers une structure UNICODE_STRING qui contient le chemin d’accès de la nouvelle clé de Registre. Le chemin peut être absolu ou relatif. Si le chemin d’accès est absolu, cette structure contient un chemin d’accès complet qui commence par le caractère « \ ». Pour un chemin d’accès absolu, le membre RootObject spécifie la clé \REGISTRY , qui est le répertoire racine de l’arborescence du Registre. Si le chemin d’accès est relatif, le chemin commence par un caractère autre que « \ » et est relatif à la clé spécifiée par le membre RootObject .

RootObject

Pointeur vers l’objet de clé de Registre qui sert de racine pour le chemin spécifié par le membre CompleteName .

ObjectType

Le membre ObjectType est réservé à un usage interne. Les pilotes ne doivent pas accéder à ce membre.

CreateOptions

Or au niveau du bit d’indicateurs. Pour plus d’informations sur ces indicateurs, consultez le paramètre CreateOptions de la routine ZwCreateKey .

Class

Pointeur vers une structure UNICODE_STRING qui identifie la classe d’objet de la clé. Pour plus d’informations sur ce membre, consultez le paramètre Class de la routine ZwCreateKey .

SecurityDescriptor

Pointeur vers une structure de SECURITY_DESCRIPTOR qui contient des informations de sécurité pour l’objet clé.

SecurityQualityOfService

Pointeur vers une structure SECURITY_QUALITY_OF_SERVICE , qui est définie dans Winnt.h.

DesiredAccess

Masque d’accès spécifié par le thread qui tente de créer la clé de Registre.

GrantedAccess

Masque d’accès qui indique les droits d’accès qui ont été accordés au thread qui tente de créer la clé de Registre. Pour plus d’informations sur ce membre, consultez Remarques.

Disposition

Valeur qui indique si la clé de Registre a été créée. Pour plus d’informations sur ce membre, consultez le paramètre Disposition de la routine ZwCreateKey et la section Remarques suivante.

ResultObject

Pointeur vers un emplacement qui reçoit l’adresse de l’objet clé qui représente la clé de Registre créée. Pour plus d’informations sur ce membre, consultez Remarques.

CallContext

Informations de contexte facultatives définies par le pilote que la routine RegistryCallback du pilote peut fournir.

RootObjectContext

Pointeur vers des informations de contexte définies par le pilote que le pilote a associées à la racine du chemin d’accès de l’objet de Registre en appelant CmSetCallbackObjectContext.

Transaction

Pointeur vers un objet de transaction sur lequel l’opération est tentée. Si ce membre a la valeur NULL, l’opération est effectuée dans un contexte non transactionnel.

Reserved

Si ce membre a la valeur 1, il est sûr de convertir cette structure en type REG_CREATE_KEY_INFORMATION_V1, qui contient des paramètres supplémentaires.

Remarques

Le gestionnaire de configuration transmet cette structure à la routine RegistryCallback chaque fois qu’un thread tente de créer une clé, par exemple, lorsqu’un thread en mode utilisateur appelle RegCreateKey ou RegCreateKeyEx ou lorsqu’un pilote appelle ZwCreateKey.

Si la routine RegistryCallback du pilote retourne STATUS_CALLBACK_BYPASS pour une notification RegNtPreCreateKeyEx , le pilote doit fournir les valeurs GrantedAccess, Disposition et ResultObject .

Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels du Registre.