Fonction NtQueryMultipleValueKey (winternl.h)
[Cette fonction peut être modifiée ou supprimée de Windows sans préavis.]
Récupère les valeurs de la clé à valeurs multiples spécifiée.
Syntaxe
__kernel_entry NTSTATUS NtQueryMultipleValueKey(
[in] HANDLE KeyHandle,
[in, out] PKEY_VALUE_ENTRY ValueEntries,
[in] ULONG EntryCount,
[out] PVOID ValueBuffer,
[in, out] PULONG BufferLength,
[out, optional] PULONG RequiredBufferLength
);
Paramètres
[in] KeyHandle
Handle de la clé pour laquelle récupérer des valeurs. Le handle doit être ouvert avec le droit d’accès KEY_QUERY_VALUE .
[in, out] ValueEntries
Pointeur vers un tableau de structures [KEY_VALUE_ENTRY] contenant les noms des valeurs à récupérer.
[in] EntryCount
Nombre d’éléments dans le tableau ValueEntries .
[out] ValueBuffer
Pointeur vers une mémoire tampon pour recevoir les valeurs.
[in, out] BufferLength
Pointeur vers une variable qui contient la taille de la mémoire tampon dans ValueBuffer, en octets. Lorsque la fonction retourne, le paramètre BufferLength contient le nombre d’octets écrits dans la mémoire tampon dans ValueBuffer.
[out, optional] RequiredBufferLength
Pointeur vers une variable pour recevoir le nombre d’octets requis pour toutes les valeurs à retourner par la fonction. Ce paramètre peut être NULL.
Valeur retournée
Retourne un code d’erreur ou NTSTATUS .
Si la mémoire tampon est trop petite pour contenir les informations à récupérer, la fonction retourne STATUS_BUFFER_OVERFLOW et, si le paramètre RequiredBufferLength est spécifié, lui affecte la taille de mémoire tampon requise.
Les formes et l’importance des codes d’erreur NTSTATUS sont répertoriées dans le fichier d’en-tête Ntstatus.h disponible dans le WDK et sont décrits dans la documentation WDK.
Remarques
Cette fonction n’a aucun fichier d’en-tête associé. Vous pouvez également utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Ntdll.dll.
Configuration requise
| Plateforme cible | Windows |
| En-tête | winternl.h |
| Bibliothèque | ntdll.lib |
| DLL | ntdll.dll |