NetDfsRemoveFtRoot-Funktion (lmdfs.h)
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 |