NetDfsRemoveFtRoot-Funktion (lmdfs.h)

Artikel
08/24/2023

Entfernt das angegebene Stammziel aus einem domänenbasierten DFS-Namespace (Distributed File System). Wenn das letzte Stammziel des DFS-Namespace entfernt wird, löscht die Funktion auch den DFS-Namespace. Ein DFS-Namespace kann gelöscht werden, ohne zuvor alle Darin enthaltenen Links zu löschen.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRoot(
  [in] LPWSTR ServerName,
  [in] LPWSTR RootShare,
  [in] LPWSTR FtDfsName,
       DWORD  Flags
);

Parameter

[in] ServerName

Zeiger auf eine Zeichenfolge, die den Servernamen des zu entfernenden Stammziels angibt. Der Server muss den Stamm eines domänenbasierten DFS-Namespace hosten. Dieser Parameter ist erforderlich.

[in] RootShare

Zeiger auf eine Zeichenfolge, die den Namen der zu entfernenden DFS-Stammzielfreigabe angibt. Dieser Parameter ist erforderlich.

[in] FtDfsName

Zeiger auf eine Zeichenfolge, die den Namen des domänenbasierten DFS-Namespace angibt, aus dem das Stammziel entfernt werden soll. Dieser Parameter ist erforderlich. In der Regel ist er identisch mit dem RootShare-Parameter .

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

Der Stammzielserver muss verfügbar und zugänglich sein. Andernfalls schlägt der Aufruf der NetDfsRemoveFtRoot-Funktion fehl.

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

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