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 |
|---|---|
|
Une mémoire tampon temporaire requise par cette fonction n’a pas pu être allouée. |
|
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. |
|
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 . |
|
Le paramètre ObjectAttributes contenait un membre ObjectName dans la structure des _ attributs de l’objet qui est 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. |
|
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 |
|