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_WINNTFORCE_UNICODE ,则此字符串为 Unicode。

[in] UseName

指向字符串的指针,该字符串指定要为其返回信息的连接的名称。

如果定义了 _WIN32_WINNTFORCE_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

另请参阅

NetUseEnum

网络管理功能

网络管理概述

USE_INFO_0

USE_INFO_1

USE_INFO_2

使用函数

WNetGetConnection