NtOpenDirectoryObject fonction)

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

Ouvre un objet d’annuaire existant.

Syntaxe

NTSTATUS WINAPI NtOpenDirectoryObject(
  _Out_ PHANDLE            DirectoryHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes
);

Paramètres

DirectoryHandle [ à]

Handle vers l’objet d’annuaire récemment ouvert.

DesiredAccess [ dans]

_ Masque d’accès qui spécifie l’accès demandé à l’objet d’annuaire. Ce paramètre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
Répertoire _ REQUÊTE
0x0001
Interroger l’accès à l’objet d’annuaire.
Répertoire _ Parcourir
0x0002
Nom : recherche l’accès à l’objet d’annuaire.
Répertoire _ CRÉER l' _ objet
0x0004
Accès de création de nom à l’objet d’annuaire.
Répertoire _ CRÉER un _ sous-répertoire
0x0008
Sous-répertoire-création de l’accès à l’objet d’annuaire.
Répertoire _ Tous _ les
droits d’accès
standard _ _ requis | 0xF
Tous les droits précédents et les _ droits standard _ requis.

ObjectAttributes [ dans]

Attributs de l’objet d’annuaire. Pour initialiser la structure des _ attributs d’objet , utilisez la macro InitializeObjectAttributes . Pour plus d’informations, consultez la documentation de ces éléments dans la documentation du kit WDK.

Valeur retournée

La fonction retourne l’état _ Success ou un état d’erreur. Les codes d’État possibles sont les suivants :

Code de retour Description
ressources dont l’État est _ insuffisant _
Une mémoire tampon temporaire requise par cette fonction n’a pas pu être allouée.
paramètre d’état _ non valide _
Le paramètre ObjectAttributes spécifié était un pointeur null , n’est pas un pointeur valide vers une structure d' _ attributs d’objet , ou certains des membres spécifiés dans la structure des _ attributs de l’objet n’étaient pas valides.
nom de l’objet d’état _ _ _ non valide
Le paramètre ObjectAttributes contenait un membre ObjectName dans la structure d' _ attributs d’objet qui n’était pas valide, car une chaîne vide a été trouvée après le caractère de _ _ _ séparation du chemin d’accès du nom d’objet .
nom de l’objet d’état _ _ _ _ introuvable
Le paramètre ObjectAttributes contenait un membre ObjectName dans la structure des _ attributs de l’objet qui est introuvable.
_ _ chemin d’accès à l’objet d’état _ _ introuvable
Le paramètre ObjectAttributes contenait un membre ObjectName dans la structure d' _ attributs de l’objet avec un chemin d’accès d’objet qui est introuvable.
État _ _syntaxe du chemin d’accès à l’objet _ _ incorrecte
Le paramètre ObjectAttributes ne contenait pas de membre RootDirectory , mais le membre ObjectName dans la structure des _ attributs de l’objet était une chaîne vide ou ne contient pas de caractère de _ _ _ séparation du chemin d’accès au nom de l’objet. Cela indique une syntaxe incorrecte pour le chemin d’accès de l’objet.

Notes

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

NtQueryDirectoryObject