NetDfsGetSupportedNamespaceVersion 函数 (lmdfs.h)

项目
02/28/2024

确定支持的元数据版本号。

语法

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

参数

[in] Origin

一个DFS_NAMESPACE_VERSION_ORIGIN枚举值，该值指定 DFS 命名空间版本的源。

[in] pName

一个指定服务器名称或域名的字符串。如果 Origin 参数的值为 DFS_NAMESPACE_VERSION_ORIGIN_DOMAIN，则此字符串必须是 AD DS 域名。否则，它必须是服务器名称。此参数是必需的，不能为 NULL。

[out] ppVersionInfo

指向接收 DFS 元数据版本号的 DFS_SUPPORTED_NAMESPACE_VERSION_INFO 结构的指针。

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值为系统错误代码。有关错误代码的列表，请参阅系统错误代码。

注解

此函数可用于确定要传递给 NetDfsAddRootTarget 函数的相应版本号。

可用于新 DFS 命名空间的 DFS 元数据的版本号取决于以下各项：

对于基于域的 DFS 命名空间，即 AD DS 域中正在使用的 DFS 元数据架构支持的版本。
承载 DFS 根目标的服务器支持的版本。

因此，可用于新 DFS 命名空间的最大 DFS 元数据版本号是 AD DS 域支持的最小版本和服务器支持的版本。可以通过调用 NetDfsGetSupportedNamespaceVersion 函数来确定此最大值，其中 pName 参数设置为承载新 DFS 根目标的服务器的名称， 并将 Origin 参数设置为 DFS_NAMESPACE_VERSION_ORIGIN_COMBINED。

要求

要求	值
最低受支持的客户端	Windows Vista SP1
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	lmdfs.h (包括 LmDfs.h、Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll