ZwQueryObject, fonction (ntifs.h)

Article
12/21/2024

La routine ZwQueryObject fournit des informations sur un objet fourni.

Syntaxe

NTSYSAPI NTSTATUS ZwQueryObject(
  [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 vers l’objet pour obtenir des informations sur.

[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 par 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 ZwQueryObject retourne STATUS_SUCCESS, la variable contient la quantité de données retournées. Si ZwQueryObject 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 de retour

ZwQueryObject retourne STATUS_SUCCESS ou un état d’erreur approprié. Les codes d’état d’erreur possibles sont les suivants :

Retourner le code	Description
STATUS_ACCESS_DENIED	Il y avait des autorisations 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 ZwQueryObject 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 de 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 Using Nt and Zw Versions of the Native System Services Routines.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h, FltKernel.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

à l’aide de versions Nt et Zw des routines natives des services système

Partager via