NetDfsSetSecurity-Funktion (lmdfs.h)
Legt den Sicherheitsdeskriptor für das Stammobjekt des angegebenen DFS-Namespace fest.
Syntax
NET_API_STATUS NET_API_FUNCTION NetDfsSetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parameter
[in] DfsEntryPath
Zeiger auf eine Zeichenfolge, die den UNC-Pfad (Universal Naming Convention) eines DFS-Namespacestamms angibt.
Die Zeichenfolge kann in einer von zwei Formen sein. Das erste Formular lautet wie folgt:
\\ Servername\DfsName
wobei ServerName der Name des Stammzielservers ist, der den eigenständigen DFS-Namespace hostet, und Dfsname ist der Name des DFS-Namespace.
Das zweite Formular lautet wie folgt:
\\ Domänenname\DomDfsName
Dabei ist DomainName der Name der Domäne, die den domänenbasierten DFS-Namespace hostet, und DomDfsName ist der Name des DFS-Namespace.
[in] SecurityInformation
SECURITY_INFORMATION Struktur, die Bitflags enthält, die den Typ der Sicherheitsinformationen angeben, die für das Stammobjekt festgelegt werden sollen.
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR Struktur, die den sicherheitsrelevanten Deskriptor enthält, der festgelegt werden soll, wie im SecurityInformation-Parameter angegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.
Hinweise
Bei domänenbasierten DFS-Namespaces wird der Sicherheitsdeskriptor für das Objekt "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" in Active Directory auf dem primären Domänencontroller (PDC) der Domäne festgelegt, die den DFS-Namespace hostet, wobei <DomDfsName> der Name des domänenbasierten DFS-Namespace <und domäne> der distinguished Name der Active Directory-Domäne ist, die den Namespace hostet.
Für eigenständige Wurzeln wird der Sicherheitsdeskriptor für das Objekt festgelegt, das durch den Registrierungseintrag HKLM\Software\Microsoft\Dfs\Standalone\<root-name> angegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | lmdfs.h (include LmDfs.h, Lm.h) |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |