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
指向指定通用命名约定 (UNC) DFS 根或链接路径的字符串的指针。
对于链接，字符串可以是两种形式之一。 第一种形式如下所示：
\\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) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |