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 命名空間版本原點的DFS_NAMESPACE_VERSION_ORIGIN 列舉值。

[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)
程式庫	Netapi32.lib
Dll	Netapi32.dll