Fonction NetDfsGetSecurity (lmdfs.h)

Article
03/02/2024

Récupère le descripteur de sécurité pour l’objet racine de l’espace de noms DFS spécifié.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetDfsGetSecurity(
  [in]  LPWSTR               DfsEntryPath,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] LPDWORD              lpcbSecurityDescriptor
);

Paramètres

[in] DfsEntryPath

Pointeur vers une chaîne qui spécifie le chemin d’accès UNC (Universal Naming Convention) d’une racine d’espace de noms DFS.

La chaîne peut être sous l’une des deux formes suivantes. Le premier formulaire est le suivant :

\\ Servername\DfsName

où ServerName est le nom du serveur cible racine qui héberge l’espace de noms DFS autonome et Dfsname est le nom de l’espace de noms DFS.

Le deuxième formulaire est le suivant :

\\ Domainname\DomDfsName

où DomainName est le nom du domaine qui héberge l’espace de noms DFS basé sur le domaine et DomDfsName est le nom de l’espace de noms DFS.

[in] SecurityInformation

SECURITY_INFORMATION structure qui contient des indicateurs de bits qui indiquent le type d’informations de sécurité à récupérer à partir de l’objet racine.

[out] ppSecurityDescriptor

Pointeur vers une liste de structures SECURITY_DESCRIPTOR qui contiennent les éléments de sécurité demandés dans le paramètre SecurityInformation .

Note Cette mémoire tampon doit être libérée en appelant la fonction NetApiBufferFree .

[out] lpcbSecurityDescriptor

Taille de la mémoire tampon vers laquelle pointe ppSecurityDescriptor , en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Remarques

Pour les espaces de noms DFS basés sur un domaine, le descripteur de sécurité est récupéré à partir de l’objet « CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain » dans Active Directory à partir du contrôleur de domaine principal (PDC) du domaine qui héberge l’espace de noms DFS, où DomDfsName est le nom de l’espace de noms DFS basé sur le domaine et <domaine> est le nom unique du domaine Active Directory qui héberge l’espace de noms.

Pour les racines autonomes, le descripteur de sécurité est récupéré à partir de l’objet spécifié par l’entrée de registre denom> racine autonome<\ MicrosoftDfs\HKLM\\Software\.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2008
Plateforme cible	Windows
En-tête	lmdfs.h (include LmDfs.h, Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

Fonctions DFS (Distributed File System)

NetDfsSetSecurity

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Partager via