NetDfsAddStdRoot-Funktion (lmdfs.h)

Artikel
02/28/2024

Erstellt einen neuen eigenständigen DFS-Namespace (Distributed File System).

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsAddStdRoot(
  [in]           LPWSTR ServerName,
  [in]           LPWSTR RootShare,
  [in, optional] LPWSTR Comment,
  [in]           DWORD  Flags
);

Parameter

[in] ServerName

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

[in] RootShare

Zeiger auf eine Zeichenfolge, die den Namen des freigegebenen Ordners für den neuen eigenständigen DFS-Namespace auf dem Server angibt, der den Namespace hostet. Dieser Parameter ist erforderlich.

[in, optional] Comment

Zeiger auf eine Zeichenfolge, die einen optionalen Kommentar enthält, der dem DFS-Namespace zugeordnet ist.

[in] Flags

Dieser Parameter ist reserviert und muss null sein.

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

Die vom RootShare-Parameter angegebene Freigabe muss bereits auf dem Server vorhanden sein, der das neue DFS-Stammziel hostet. Diese Funktion erstellt keine neue Freigabe.

Der Aufrufer muss über Administratorrechte auf dem DFS-Server verfügen. Weitere Informationen zum Aufrufen von Funktionen, die Administratorrechte erfordern, finden Sie unter Ausführen mit speziellen Berechtigungen.

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