NetDfsGetFtContainerSecurity-Funktion (lmdfs.h)

Artikel
02/28/2024

Ruft den Sicherheitsdeskriptor des Containerobjekts für die domänenbasierten DFS-Namespaces in der angegebenen Active Directory-Domäne ab.

Syntax

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

Parameter

[in] DomainName

Zeiger auf eine Zeichenfolge, die den Active Directory-Domänennamen angibt.

[in] SecurityInformation

SECURITY_INFORMATION Struktur, die Bitflags enthält, die den Typ der abzurufenden Sicherheitsinformationen angeben.

[out] ppSecurityDescriptor

Zeiger auf eine Liste SECURITY_DESCRIPTOR Strukturen, die die im SecurityInformation-Parameter angeforderten Sicherheitselemente enthalten.

Hinweis Dieser Puffer muss durch Aufrufen der NetApiBufferFree-Funktion freigegeben werden.

[out] lpcbSecurityDescriptor

Die Größe von ppSecurityDescriptor 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

Der Sicherheitsdeskriptor wird aus dem Objekt "CN=DFS-Configuration,CN=System,DC=domain" in Active Directory vom primären Domänencontroller (PDC) der domäne abgerufen, die im DomainName-Parameter angegeben ist, wobei domäne der distinguished name der domäne ist, der im DomainName-Parameter angegeben ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	lmdfs.h (include LmDfs.h, Lm.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

DFS-Funktionen (Distributed File System)

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Freigeben über