IRegistryKey ::QueryRegistryValues, méthode (portcls.h)
La méthode QueryRegistryValues permet à l’appelant d’interroger plusieurs valeurs à partir du Registre avec un seul appel.
Syntaxe
NTSTATUS QueryRegistryValues(
[in] PRTL_QUERY_REGISTRY_TABLE QueryTable,
[in, optional] PVOID Context
);
Paramètres
[in] QueryTable
Pointeur vers un tableau d’une ou plusieurs structures RTL_QUERY_REGISTRY_TABLE. (Cette structure est décrite dans RtlQueryRegistryValues.) Chaque structure spécifie le nom de valeur et le nom de sous-clé d’une entrée de Registre que l’appelant interroge. Chaque structure contient également un pointeur de fonction vers un appelant fourni QueryRoutine rappel que la méthode QueryRegistryValues appellera avec des informations sur l’entrée de Registre correspondante. Le tableau doit être arrêté par une structure avec un membre NameNULL.
[in, optional] Context
Il s’agit d’une valeur de contexte définie par l’appelant. La méthode QueryRegistryValues transmet cette valeur en tant que paramètre d’appel à chacun des rappels QueryRoutine. La valeur de contexte est généralement un pointeur vers une structure définie par l’appelant contenant des données de contexte auxquelles l’appelant accède QueryRoutine. La valeur de contexte est castée en type PVOID de pointeur, mais la méthode QueryRegistryValues n’effectue aucune validation du pointeur.
Valeur de retour
QueryRegistryValues retourne STATUS_SUCCESS si l’appel a réussi à traiter l’intégralité du QueryTable. Sinon, la méthode retourne un code d’erreur approprié. Le tableau suivant présente certains des codes d’état de retour possibles.
| Retourner le code | Description |
|---|---|
|
Indique que le paramètre QueryTable passé à la méthode n’est pas valide. |
|
Indique que la méthode n’a pas pu trouver l’objet spécifié dans l’une des entrées QueryTable. |
Remarques
Cette méthode utilise des routines de rappel fournies par l’appelant pour énumérer les valeurs d’une liste d’entrées de Registre. Si elle réussit, la méthode retourne après avoir appelé toutes les routines de rappel dans la liste.
Le paramètre QueryTable pointe vers un tableau de structures RTL_QUERY_REGISTRY_TABLE. Le premier membre de cette structure, QueryRoutine, est un pointeur de fonction vers une routine de rappel fournie par l’appelant. Pour plus d’informations, consultez RtlQueryRegistryValues.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |