structure REG_CREATE_KEY_INFORMATION (wdm.h)

Article
02/07/2025

Obsolète. À compter de Windows 7, utilisez REG_CREATE_KEY_INFORMATION_V1, la version V1 de cette structure à la place.

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

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 d’accès peut être absolu ou relatif. Si le chemin d’accès est absolu, cette structure contient un chemin complet qui commence par le caractère « \ ». Pour un chemin 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 d’accès spécifié par le membre CompleteName.

ObjectType

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

CreateOptions

Or au niveau du bit des 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 de classe de la routine ZwCreateKey.

SecurityDescriptor

Pointeur vers une structure 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 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 suivantes.

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 contextuelles 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 associées à la racine du chemin d’accès de l’objet de Registre en appelant CmSetCallbackObjectContext.

Transaction

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

Reserved

Si ce membre est 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, Dispositionet ResultObject.

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