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

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.

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

Voir aussi

IRegistryKey

RtlQueryRegistryValues