REG_QUERY_VALUE_KEY_INFORMATION structure (wdm.h)
La structure REG_QUERY_VALUE_KEY_INFORMATION contient des informations sur l’entrée de valeur d’une clé de Registre qui est interrogée.
Syntaxe
typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
PVOID Object;
PUNICODE_STRING ValueName;
KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
PVOID KeyValueInformation;
ULONG Length;
PULONG ResultLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;
Membres
Object
Pointeur vers l’objet de clé de Registre pour la clé dont l’entrée de valeur est interrogée.
ValueName
Pointeur vers une structure UNICODE_STRING qui contient le nom de l’entrée de valeur pour laquelle récupérer des informations.
KeyValueInformationClass
Valeur KEY_VALUE_INFORMATION_CLASS qui indique le type d’informations à retourner par le système.
KeyValueInformation
Pointeur vers une mémoire tampon qui contient les informations à retourner par le système. Le format de la mémoire tampon dépend de la valeur de KeyValueInformationClass. Pour plus d’informations , consultez KEY_VALUE_INFORMATION_CLASS.
Length
Taille, en octets, de la mémoire tampon KeyValueInformation .
ResultLength
Pointeur vers une variable qui reçoit (du système) la quantité de données valides, en octets, dans la mémoire tampon KeyValueInformation .
CallContext
Informations contextuelles facultatives définies par le pilote que la routine RegistryCallback du pilote peut fournir. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.
ObjectContext
Pointeur vers les informations de contexte définies par le pilote que le pilote a associées à un objet de Registre en appelant CmSetCallbackObjectContext. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.
Reserved
Ce membre est réservé pour un usage ultérieur. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.
Remarques
Le système transmet cette structure à une routine RegistryCallback chaque fois qu’un thread tente d’interroger une entrée de valeur pour une clé, par exemple lorsqu’un thread en mode utilisateur appelle RegQueryValue ou RegQueryValueEx ou lorsqu’un pilote appelle ZwDeleteKey.
Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels de registre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible sur Microsoft Windows XP et versions ultérieures du système d’exploitation Windows. |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |