structure REG_CREATE_KEY_INFORMATION (wdm.h)
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.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |