NetDfsGetStdContainerSecurity-Funktion (lmdfs.h)

Artikel
03/01/2024

Ruft den Sicherheitsdeskriptor für das Containerobjekt des angegebenen eigenständigen DFS-Namespace ab.

Syntax

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

Parameter

[in] MachineName

Zeiger auf eine Zeichenfolge, die den Namen des Servers angibt, der den eigenständigen DFS-Namespace hostet.

[in] SecurityInformation

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

[out] ppSecurityDescriptor

Zeiger auf eine Liste von 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 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

Der Sicherheitsdeskriptor wird aus dem Objekt abgerufen, das vom eigenständigen HkLM-Softwareschlüssel\\Microsoft\Dfs\ in der Registrierung des Im MachineName-Parameter angegebenen Servers angegeben wird.

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