NetDfsAddRootTarget-Funktion (lmdfs.h)

Artikel
03/01/2024

Erstellt einen domänenbasierten oder eigenständigen DFS-Namespace oder fügt einem vorhandenen domänenbasierten Namespace ein neues Stammziel hinzu.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  MajorVersion,
  [in, optional] LPWSTR pComment,
  [in]           ULONG  Flags
);

Parameter

[in] pDfsPath

Zeiger auf eine Zeichenfolge, die den UNC-Pfad (Universal Naming Convention) eines DFS-Namespaces angibt.

Für einen eigenständigen DFS-Namespace sollte diese Zeichenfolge das folgende Format aufweisen:

\\Servername\DfsName

Dabei ist ServerName der Name des Servers, der das neue DFS-Stammziel hostet, und DfsName ist der Name des DFS-Namespace.

Für einen domänenbasierten DFS-Namespace sollte diese Zeichenfolge das folgende Format aufweisen:

\\Domänenname\DomDfsName

Dabei ist DomainName der Name der Domäne, die den domänenbasierten DFS-Namespace hostet, und DomDfsName ist der Name des neuen oder vorhandenen domänenbasierten DFS-Namespace. Aus Kompatibilitätsgründen sollte DomDfsName mit dem Namen des freigegebenen Ordners auf dem Server identisch sein, der das neue DFS-Stammziel hostet.

[in, optional] pTargetPath

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den UNC-Pfad eines DFS-Stammziels für den DFS-Namespace angibt, der im pDfsPath-Parameter angegeben ist.

Für einen eigenständigen DFS-Namespace muss dieser Parameter NULL sein. Für einen domänenbasierten DFS-Namespace sollte die Zeichenfolge das folgende Format aufweisen:

\\Servername\RootShare

Wobei ServerName der Name des Servers ist, der das neue DFS-Stammziel hostet, und RootShare ist der Name des freigegebenen Ordners auf dem Server. Die von RootShare angegebene Freigabe muss bereits auf dem Server vorhanden sein, auf dem das neue DFS-Stammziel gehostet wird. Diese Funktion erstellt keine neue Freigabe.

[in] MajorVersion

Gibt die DFS-Metadatenversion für den Namespace an.

Hinweis Dieser Parameter wird nur beim Erstellen eines neuen Namespace verwendet.

Wenn ein eigenständiger DFS-Namespace erstellt wird, muss dieser Parameter auf 1 festgelegt werden.

Wenn ein domänenbasierter Namespace erstellt wird, sollte dieser Parameter wie folgt festgelegt werden:

Legen Sie es auf 1 fest, um den Windows 2000-Modus anzugeben.
Legen Sie es auf 2 oder höher fest, um den Windows Server 2008-Modus anzugeben.

Wenn einem vorhandenen domänenbasierten DFS-Namespace ein neues Stammziel hinzugefügt wird, muss dieser Parameter auf 0 festgelegt werden.

[in, optional] pComment

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die einen Kommentar enthält, der dem DFS-Stamm 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 sich die Domäne nicht auf der erforderlichen Funktionsebene für die angegebene MajorVersion befindet, wird der Rückgabewert ERROR_DS_INCOMPATIBLE. Dieser Rückgabewert gilt nur für Domänenwurzeln und eine MajorVersion von 2.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Der Aufrufer muss über Administratorrechte auf dem DFS-Server verfügen.

Um die DFS-Metadatenversion zu bestimmen, die im Parameter MajorVersion angegeben werden kann, verwenden Sie die NetDfsGetSupportedNamespaceVersion-Funktion .

Die folgende Tabelle zeigt, welche Parameterwerte Sie entsprechend dem gewünschten Ergebnis angeben sollten.

pDfsPath-Parameter	pTargetPath-Parameter	MajorVersion-Parameter	Ergebnis
\\Domänenname\DomDfsName	\\ServerName\RootShare	1	Erstellen Sie einen domänenbasierten DFS-Namespace im Windows 2000-Modus, oder fügen Sie einem vorhandenen ein neues Stammziel hinzu.
\\Domänenname\DomDfsName	\\ServerName\RootShare	2	Erstellen Sie einen domänenbasierten DFS-Namespace im Windows Server 2008-Modus, oder fügen Sie einem vorhandenen ein neues Stammziel hinzu.
\\Domänenname\DomDfsName	\\ServerName\RootShare	0	Fügen Sie einem vorhandenen Windows 2000-Modus oder einem domänenbasierten DFS-Namespace im Windows Server 2008-Modus ein neues Stammziel hinzu.
\\ServerName\DfsName	NULL	Muss 1 sein.	Erstellen Sie einen eigenständigen DFS-Namespace.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	lmdfs.h (include LmDfs.h, Lm.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll