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