NetDfsGetClientInfo 函式 (lmdfs.h)
從 DFS 用戶端維護的快取擷取分散式文件系統 (DFS) 根或連結的相關信息。
語法
NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo(
[in] LPWSTR DfsEntryPath,
[in, optional] LPWSTR ServerName,
[in, optional] LPWSTR ShareName,
[in] DWORD Level,
[out] LPBYTE *Buffer
);
參數
[in] DfsEntryPath
字串的指標，指定 DFS 根目錄或連結 (UNC) 路徑的通用命名慣例。
對於連結，字串可以是兩種形式的其中一種。 第一個表單如下所示：
\\ServerName\DfsName\link_path
其中 ServerName 是裝載獨立 DFS 命名空間之根目標伺服器的名稱; DfsName 是 DFS 命名空間的名稱;和 link_path 是 DFS 連結。
第二個表單如下所示：
\\DomainName\DomDfsname\link_path
其中 DomainName 是裝載網域型 DFS 命名空間的功能變數名稱; DomDfsname 是 DFS 命名空間的名稱;和 link_path 是 DFS 連結。
針對根目錄，字串可以是下列兩種形式之一：
\\ServerName\DfsName
或
\\DomainName\DomDfsname
其中名稱的值與先前所述的值相同。
此為必要參數。
[in, optional] ServerName
字串的指標，指定 DFS 根目標或連結目標伺服器的名稱。 這是選擇性參數。
[in, optional] ShareName
字串的指標，指定對應至 DFS 根目標或連結目標的共享名稱。 這是選擇性參數。
[in] Level
指定要求的信息層級。 此參數可以是下列其中一個值。
1
傳回 DFS 根或 DFS 連結名稱。 Buffer 參數指向DFS_INFO_1結構。
2
傳回 DFS 根目錄或 DFS 連結名稱、狀態和 DFS 目標數目。 Buffer 參數指向DFS_INFO_2結構。
3
傳回 DFS 根目錄或 DFS 連結名稱、狀態和目標資訊。 Buffer 參數指向DFS_INFO_3結構。
4
傳回 DFS 根或 DFS 連結名稱、狀態、 GUID、逾時和目標資訊。 Buffer 參數指向DFS_INFO_4結構。
[out] Buffer
接收要求信息的緩衝區位址指標。 此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。 如需詳細資訊，請參閱 網路管理功能緩衝區 和 網路管理功能緩衝區長度。
傳回值
如果函式成功，傳回值 會NERR_Success。
如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。
備註
使用 NetDfsGetClientInfo 函式不需要特殊群組成員資格。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |