Fonction NetDfsSetSecurity (lmdfs.h)
Définit le descripteur de sécurité pour l’objet racine de l’espace de noms DFS spécifié.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetDfsSetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
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é à définir sur l’objet racine.
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR structure qui contient le descripteur de sécurité à définir comme spécifié dans le paramètre SecurityInformation .
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 défini sur l’objet « CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain » dans Active Directory au niveau 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 défini sur 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 |