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 |
|