Fonction NtQueryDirectoryObject
[Cette fonction peut être modifiée ou indisponible à 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 [in]
-
Handle de l’objet directory.
-
Mémoire tampon [out, facultatif]
-
Pointeur vers une mémoire tampon qui reçoit les informations du répertoire. Cette mémoire tampon reçoit une ou plusieurs structures OBJECT_DIRECTORY_INFORMATION , la dernière étant NULL, suivie de chaînes qui contiennent les noms des entrées de répertoire. Pour plus d'informations, consultez la section Notes.
-
Longueur [in]
-
Taille de la mémoire tampon de sortie fournie par l’utilisateur, en octets.
-
ReturnSingleEntry [in]
-
Indique si la fonction ne doit retourner qu’une seule entrée.
-
RestartScan [in]
-
Indique s’il faut redémarrer l’analyse ou poursuivre l’énumération à l’aide des informations transmises dans le paramètre Context .
-
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 STATUS_SUCCESS ou une erreur status.
Notes
Voici la définition de la structure OBJECT_DIRECTORY_INFORMATION .
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 .
Spécifications
| Condition requise | Valeur |
|---|---|
| DLL |
|
Voir aussi