NetDfsGetSupportedNamespaceVersion-Funktion (lmdfs.h)

Artikel
03/01/2024

Bestimmt die unterstützte Versionsnummer der Metadaten.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsGetSupportedNamespaceVersion(
  [in]  DFS_NAMESPACE_VERSION_ORIGIN          Origin,
  [in]  PWSTR                                 pName,
  [out] PDFS_SUPPORTED_NAMESPACE_VERSION_INFO *ppVersionInfo
);

Parameter

[in] Origin

Ein DFS_NAMESPACE_VERSION_ORIGIN Enumerationswert, der den Ursprung der DFS-Namespaceversion angibt.

[in] pName

Eine Zeichenfolge, die den Server- oder Domänennamen angibt. Wenn der Wert des Origin-ParametersDFS_NAMESPACE_VERSION_ORIGIN_DOMAIN ist, muss diese Zeichenfolge ein AD DS-Domänenname sein. Andernfalls muss es sich um einen Servernamen handeln. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] ppVersionInfo

Ein Zeiger auf eine DFS_SUPPORTED_NAMESPACE_VERSION_INFO-Struktur , die die Versionsnummer der DFS-Metadaten empfängt.

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

Diese Funktion ist nützlich, um eine geeignete Versionsnummer zu ermitteln, die an die NetDfsAddRootTarget-Funktion übergeben werden soll.

Die Versionsnummer der DFS-Metadaten, die für einen neuen DFS-Namespace verwendet werden können, hängt von Folgendem ab:

Für domänenbasierte DFS-Namespaces die Version, die vom DFS-Metadatenschema unterstützt wird, das in der AD DS-Domäne verwendet wird.
Die Version, die vom Server unterstützt wird, der das DFS-Stammziel hosten soll.

Daher ist die maximale Versionsnummer der DFS-Metadaten, die für einen neuen DFS-Namespace verwendet werden kann, die Mindestversion der von der AD DS-Domäne unterstützten Version und die vom Server unterstützte Version. Dieses Maximum kann durch Aufrufen der NetDfsGetSupportedNamespaceVersion-Funktion mit dem pName-Parameter auf den Namen des Servers festgelegt werden, der das neue DFS-Stammziel hosten soll, und den Origin-Parameterauf DFS_NAMESPACE_VERSION_ORIGIN_COMBINED festgelegt.

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