Функции общего доступа к сети
Функции общего сетевого ресурса управляют общими ресурсами. Общий ресурс — это локальный ресурс на сервере (например, каталог диска, печать устройства или именованный канал), к которому могут обращаться пользователи и приложения в сети.
Ниже перечислены функции общего доступа.
| Функция | Описание |
|---|---|
| NetShareAdd | Предоставляет общий доступ к ресурсу на сервере. |
| NetShareCheck | Запрашивает, предоставляет ли сервер общий доступ к устройству. |
| NetShareDel | Удаляет имя общей папки из списка общих ресурсов сервера. |
| NetShareEnum | Извлекает общие сведения о каждом общем ресурсе на сервере. |
| NetShareGetInfo | Извлекает сведения о указанном общем ресурсе на сервере. |
| NetShareSetInfo | Задает параметры общего ресурса. |
Функция NetShareAdd позволяет пользователю или приложению совместно использовать ресурс определенного типа с помощью указанного имени общей папки. Для функции NetShareAdd требуется имя общего ресурса и имя локального устройства. Пользователь или приложение должны иметь учетную запись на сервере для доступа к ресурсу.
Вы также можете указать дескриптор безопасности, связанный с общей папкой. Дескрипторы безопасности указывают, какие пользователи могут получать доступ к файлам через общую папку и с каким типом доступа. Укажите SECURITY_DESCRIPTOR с уровнем сведений SHARE_INFO_502 при вызове NetShareAdd или NetShareSetInfo. NetShareSetInfo поддерживает уровень сведений SHARE_INFO_1501. Дополнительные сведения о дескрипторах безопасности см. в управления доступом.
Функции управления сетями используют следующие специальные имена общих ресурсов для межпроцессного взаимодействия (IPC) и удаленного администрирования сервера:
- IPC$, зарезервированный для межпроцессного взаимодействия
- ADMIN$, зарезервированный для удаленного администрирования
- A$, B$, C$ (и другие имена локальных дисков, за которым следует знак доллара), назначенные локальным устройствам дисков
Чтобы получить список всех подключений к общему ресурсу на сервере или перечислить все подключения, установленные на определенном компьютере, вызовите функцию NetConnectionEnum. Вы можете вызывать NetConnectionEnum на CONNECTION_INFO_0 и CONNECTION_INFO_1 уровнях информации.
Функции общего доступа доступны на следующих уровнях информации:
Следующие уровни сведений допустимы только для NetShareSetInfo:
Если вы программируются для Active Directory, вы можете вызвать определенные методы интерфейса службы Active Directory (ADSI) для достижения той же функциональности, которую можно достичь, вызвав функции общего сетевого управления. Дополнительные сведения см. в разделе IADsFileShare.