NetDfsGetSecurity-Funktion (lmdfs.h)
Ruft die Sicherheitsbeschreibung für das Stammobjekt des angegebenen DFS-Namespaces ab.
Syntax
NET_API_STATUS NET_API_FUNCTION NetDfsGetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[out] LPDWORD lpcbSecurityDescriptor
);
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 aus dem Stammobjekt abgerufen werden sollen.
[out] ppSecurityDescriptor
Zeiger auf eine Liste von SECURITY_DESCRIPTOR Strukturen, die die im SecurityInformation-Parameter angeforderten Sicherheitselemente enthalten.
[out] lpcbSecurityDescriptor
Die Größe des Puffers, auf den ppSecurityDescriptor zeigt, in Bytes.
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 aus dem Objekt "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" in Active Directory vom primären Domänencontroller (PDC) der Domäne abgerufen, die den DFS-Namespace hostet. Dabei ist DomDfsName der Name des domänenbasierten DFS-Namespace und <Domäne> der distinguished Name der Active Directory-Domäne, die den Namespace hostet.
Bei eigenständigen Roots wird die Sicherheitsbeschreibung aus dem Objekt abgerufen, das durch den Registrierungseintrag HKLM\Software\Microsoft\Dfs\Standalone\<root-name> angegeben ist.
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 |