共用函式
網路管理共用函式會控制共用資源。 共用資源是伺服器上的本機資源 (例如磁碟目錄、列印裝置或具名管道) ,可供網路上的使用者和應用程式存取。
共用函式如下所列。
函式 | 描述 |
---|---|
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。