Fonction NtQueryObject (ntifs.h)

  • Article

La routine NtQueryObject fournit des informations sur un objet fourni.

Syntaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

Paramètres

[in, optional] Handle

Handle de l’objet sur lequel obtenir des informations.

[in] ObjectInformationClass

Spécifie une valeur OBJECT_INFORMATION_CLASS qui détermine le type d’informations retournées dans la mémoire tampon ObjectInformation .

[out, optional] ObjectInformation

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit les informations demandées.

[in] ObjectInformationLength

Spécifie la taille, en octets, de la mémoire tampon ObjectInformation .

[out, optional] ReturnLength

Pointeur vers une variable qui reçoit la taille, en octets, des informations de clé demandées. Si NtQueryObject retourne STATUS_SUCCESS, la variable contient la quantité de données retournées. Si NtQueryObject retourne STATUS_BUFFER_OVERFLOW ou STATUS_BUFFER_TOO_SMALL, vous pouvez utiliser la valeur de la variable pour déterminer la taille de mémoire tampon requise.

Valeur retournée

NtQueryObject retourne STATUS_SUCCESS ou une status d’erreur appropriée. Les codes de status d’erreur possibles incluent les éléments suivants :

Code de retour Description
STATUS_ACCESS_DENIED Les autorisations étaient insuffisantes pour effectuer cette requête.
STATUS_INVALID_HANDLE Le handle d’objet fourni n’est pas valide.
STATUS_INFO_LENGTH_MISMATCH La longueur des informations n’est pas suffisante pour contenir les données.

Remarques

Si l’appel à la fonction NtQueryObject se produit en mode utilisateur, vous devez utiliser le nom « NtQueryObject » au lieu de « ZwQueryObject ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000.
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h, FltKernel.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs, PowerIrpDDis

Voir aussi

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION