Méthode IRegistryKey ::QueryRegistryValues (portcls.h)

  • Article

La QueryRegistryValues méthode 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 rappel QueryRoutine fourni par l’appelant que la QueryRegistryValues méthode appellera avec des informations sur l’entrée de Registre correspondante. Le tableau doit être terminé par une structure avec un membre Namenull.

[in, optional] Context

Il s’agit d’une valeur de contexte définie par l’appelant. La QueryRegistryValues méthode 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 le QueryRoutine de l’appelant accède. La valeur de contexte est castée en type de pointeur PVOID, mais la QueryRegistryValues méthode n’effectue aucune validation du pointeur.

Valeur retournée

QueryRegistryValues retourne STATUS_SUCCESS si l’appel a réussi à traiter l’intégralité de QueryTable. Sinon, la méthode retourne un code d’erreur approprié. Le tableau suivant présente certains des codes status de retour possibles.

Code de retour Description
STATUS_INVALID_PARAMETER
 Indique que le paramètre QueryTable qui a été passé à la méthode n’est pas valide.
STATUS_OBJECT_NAME_NOT_FOUND
 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.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Voir aussi

IRegistryKey

RtlQueryRegistryValues