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