通过

共享函数

  • 项目

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

下面列出了共享函数。

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

 

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

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

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

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

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

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

共享函数在以下信息级别可用，尽管某些共享级别仅适用于某些共享函数：

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

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