NetUseGetInfo 函数 (lmuse.h)

项目
08/24/2023

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

请求的数据的信息级别。此参数的取值可为下列值之一：

值	含义
0	指定本地设备名称和远程资源的共享名称。 BufPtr 参数是指向USE_INFO_0结构的指针。
1	指定有关本地设备与共享资源之间的连接的信息，包括连接状态和类型。 BufPtr 参数是指向USE_INFO_1结构的指针。
2	指定有关本地设备和共享资源之间的连接的信息。信息包括连接状态、连接类型、用户名和域名。 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