共享函数

网络管理共享功能控制共享资源。 共享资源是服务器上的本地资源, (例如磁盘目录、打印设备或命名管道) ,可供网络上的用户和应用程序访问。

下面列出了共享函数。

函数 说明
NetShareAdd 共享服务器上的资源。
NetShareCheck 查询服务器是否正在共享设备。
NetShareDel 从服务器的共享资源列表中删除共享名称。
NetShareEnum 检索有关服务器上每个共享资源的共享信息。
NetShareGetInfo 检索有关服务器上指定共享资源的信息。
NetShareSetInfo 设置共享资源的参数。

 

这些共享函数仅适用于服务器消息块 (LAN Manager) 服务器上的共享。 这些共享函数不支持分布式文件系统 (DFS) 共享。 例如, NetShareGetInfo 函数只能检索 SMB 服务器上指定共享资源的信息。 若要使用不同的网络提供程序 (WebDAV 或 DFS 共享(例如) )检索共享的信息,请使用 WNetGetConnection 函数。

NetShareAdd 函数允许用户或应用程序使用指定的共享名称共享特定类型的资源。 NetShareAdd 函数需要共享名称和本地设备名称才能共享资源。 用户或应用程序必须在服务器上具有帐户才能访问资源。

还可以指定要与共享关联的安全描述符。 安全描述符指定允许哪些用户通过共享访问文件,以及使用哪种类型的访问。 在调用 NetShareAddNetShareSetInfo 时,指定具有SHARE_INFO_502信息级别的SECURITY_DESCRIPTOR。 NetShareSetInfo 支持 SHARE_INFO_1501 信息级别。 有关安全描述符的详细信息,请参阅访问控制

网络管理功能使用以下特殊共享名称进行进程间通信 (IPC) 和远程管理服务器:

  • IPC$,保留用于进程间通信
  • ADMIN$,保留用于远程管理
  • A$、B$、C$ (和其他本地磁盘名称,后跟美元符号) ,分配给本地磁盘设备

若要列出与服务器上的共享资源建立的所有连接,或列出从特定计算机建立的所有连接,请调用 NetConnectionEnum 函数。 可以在CONNECTION_INFO_0CONNECTION_INFO_1信息级别调用 NetConnectionEnum

共享函数在以下信息级别可用,但某些共享级别仅适用于某些共享函数:

有关详细信息,请查看特定共享函数的文档。

如果要对 Active Directory 进行编程,则可以调用某些 Active Directory 服务接口 (ADSI) 方法来实现通过调用网络管理共享函数可以实现的相同功能。 有关详细信息,请参阅 IADsFileShare