NetDfsAddFtRoot-Funktion (lmdfs.h)

Artikel
08/24/2023

Erstellt einen neuen domänenbasierten DFS-Namespace (Distributed File System). Wenn der Namespace bereits vorhanden ist, fügt die Funktion ihr das angegebene Stammziel hinzu.

Syntax

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

Parameter

[in] ServerName

Zeiger auf eine Zeichenfolge, die den Namen des Servers angibt, auf dem das neue DFS-Stammziel gehostet wird. Dieser Wert darf keine IP-Adresse sein. Dieser Parameter ist erforderlich.

[in] RootShare

Zeiger auf eine Zeichenfolge, die den Namen des freigegebenen Ordners auf dem Server angibt, der das neue DFS-Stammziel hostet. Dieser Parameter ist erforderlich.

[in] FtDfsName

Zeiger auf eine Zeichenfolge, die den Namen des neuen oder vorhandenen domänenbasierten DFS-Namespace angibt. Dieser Parameter ist erforderlich. Aus Kompatibilitätsgründen sollte dieselbe Zeichenfolge wie der RootShare-Parameter angegeben werden.

[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 die Berechtigung zum Aktualisieren des DFS-Containers im Verzeichnisdienst verfügen und über Administratorrechte auf dem DFS-Hostserver (Stammserver) verfügen.

Anforderungen


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