NtQueryDirectoryObject fonction)

[Cette fonction peut être modifiée ou non disponible à l’avenir.]

Récupère des informations sur l’objet d’annuaire spécifié.

Syntaxe

NTSTATUS WINAPI NtQueryDirectoryObject(
  _In_      HANDLE  DirectoryHandle,
  _Out_opt_ PVOID   Buffer,
  _In_      ULONG   Length,
  _In_      BOOLEAN ReturnSingleEntry,
  _In_      BOOLEAN RestartScan,
  _Inout_   PULONG  Context,
  _Out_opt_ PULONG  ReturnLength
);

Paramètres

DirectoryHandle [ dans]

Handle de l’objet d’annuaire.

Mémoire tampon [ out, facultatif]

Pointeur vers une mémoire tampon qui reçoit les informations d’annuaire. Cette mémoire tampon reçoit une ou plusieurs structures d' _ _ informations d’annuaire d’objets , la dernière ayant la valeur null, suivie de chaînes qui contiennent les noms des entrées de répertoire. Pour plus d'informations, consultez la section Notes.

Longueur [ dans]

Taille de la mémoire tampon de sortie fournie par l’utilisateur, en octets.

ReturnSingleEntry [ dans]

Indique si la fonction doit retourner une seule entrée.

RestartScan [ dans]

Indique s’il faut redémarrer l’analyse ou continuer l’énumération à l’aide des informations passées dans le paramètre de contexte .

Contexte [ in, out]

Contexte d’énumération.

ReturnLength [ out, facultatif]

Pointeur vers une variable qui reçoit la longueur des informations de répertoire retournées dans la mémoire tampon de sortie, en octets.

Valeur retournée

La fonction retourne l’état _ Success ou un état d’erreur.

Remarques

Voici la définition de la structure d' _ _ informations de répertoire de l’objet.

typedef struct _OBJECT_DIRECTORY_INFORMATION {
    UNICODE_STRING Name;
    UNICODE_STRING TypeName;
} OBJECT_DIRECTORY_INFORMATION, *POBJECT_DIRECTORY_INFORMATION;

Cette fonction n’a pas de bibliothèque d’importation ou de fichier d’en-tête associé ; vous devez l’appeler à l’aide des fonctions LoadLibrary et GetProcAddress .

Configuration requise

Condition requise Valeur
DLL
Ntdll.dll

Voir aussi

NtOpenDirectoryObject