共享函数
网络管理共享功能控制共享资源。 共享资源是服务器上的本地资源, (例如磁盘目录、打印设备或命名管道) ,可供网络上的用户和应用程序访问。
下面列出了共享函数。
函数 | 说明 |
---|---|
NetShareAdd | 共享服务器上的资源。 |
NetShareCheck | 查询服务器是否正在共享设备。 |
NetShareDel | 从服务器的共享资源列表中删除共享名称。 |
NetShareEnum | 检索有关服务器上每个共享资源的共享信息。 |
NetShareGetInfo | 检索有关服务器上指定共享资源的信息。 |
NetShareSetInfo | 设置共享资源的参数。 |
这些共享函数仅适用于服务器消息块 (LAN Manager) 服务器上的共享。 这些共享函数不支持分布式文件系统 (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。
共享函数在以下信息级别可用,但某些共享级别仅适用于某些共享函数:
- SHARE_INFO_0
- SHARE_INFO_1
- SHARE_INFO_2
- SHARE_INFO_501
- SHARE_INFO_502
- SHARE_INFO_503
- SHARE_INFO_1004
- SHARE_INFO_1005
- SHARE_INFO_1006
- SHARE_INFO_1501
有关详细信息,请查看特定共享函数的文档。
如果要对 Active Directory 进行编程,则可以调用某些 Active Directory 服务接口 (ADSI) 方法来实现通过调用网络管理共享函数可以实现的相同功能。 有关详细信息,请参阅 IADsFileShare。