NetUseGetInfo 函数 (lmuse.h)
NetUseGetInfo 函数检索有关与共享资源的连接的信息。
还可以使用 WNetGetConnection 函数检索与本地设备关联的网络资源的名称。
语法
NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
[in] LMSTR UncServerName,
[in] LMSTR UseName,
[in] DWORD LevelFlags,
[out] LPBYTE *bufptr
);
parameters
[in] UncServerName
要执行此函数的计算机的 UNC 名称。 如果此参数为 NULL,则使用本地计算机。 如果指定的 UncServerName 参数是远程计算机,则远程计算机必须支持使用旧式远程访问协议机制的远程 RPC 调用。
如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ,则此字符串为 Unicode。
[in] UseName
指向字符串的指针,该字符串指定要为其返回信息的连接的名称。
如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ,则此字符串为 Unicode。
[in] LevelFlags
请求的数据的信息级别。 此参数的取值可为下列值之一:
值 | 含义 |
---|---|
|
指定本地设备名称和远程资源的共享名称。 BufPtr 参数是指向USE_INFO_0结构的指针。 |
|
指定有关本地设备与共享资源之间的连接的信息,包括连接状态和类型。 BufPtr 参数是指向USE_INFO_1结构的指针。 |
|
指定有关本地设备和共享资源之间的连接的信息。 信息包括连接状态、连接类型、用户名和域名。 BufPtr 参数是指向USE_INFO_2结构的指针。 |
[out] bufptr
指向接收数据的缓冲区的指针。 此数据的格式取决于 Level 参数的值。 此缓冲区由系统分配,必须使用 NetApiBufferFree 函数释放。 有关详细信息,请参阅 网络管理功能缓冲区 和 网络管理功能缓冲区长度。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值为系统错误代码。 有关错误代码的列表,请参阅 系统错误代码。
注解
调用 NetUseGetInfo 函数不需要特殊的组成员身份。 此函数不能在远程服务器上执行,除非是下层兼容性的情况。
若要列出本地计算机与远程服务器上的资源之间的所有当前连接,可以调用 NetUseEnum 函数。
此函数仅适用于服务器消息块 (LAN Manager 工作站) 客户端。 NetUseGetInfo 函数不支持分布式文件系统 (DFS) 共享。 若要使用不同的网络提供程序 (WebDAV 或 DFS 共享(例如) )检索共享的信息,请使用 WNetGetConnection 函数。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmuse.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |