Общий доступ к функциям

Функции общего доступа управления сетью управляют общими ресурсами. Общий ресурс — это локальный ресурс на сервере (например, каталог диска, устройство печати или именованный канал), к которому могут обращаться пользователи и приложения в сети.

Ниже перечислены функции общего доступа.

Функция Описание
NetShareAdd Предоставляет общий доступ к ресурсу на сервере.
NetShareCheck Запрашивает, использует ли сервер общий доступ к устройству.
NetShareDel Удаляет имя общей папки из списка общих ресурсов сервера.
NetShareEnum Извлекает общие сведения о каждом общем ресурсе на сервере.
NetShareGetInfo Извлекает сведения об указанном общем ресурсе на сервере.
NetShareSetInfo Задает параметры общего ресурса.

 

Эта функция общего доступа применяется только к общим ресурсам на сервере server Message Block (LAN Manager). Эти функции общего доступа не поддерживают общие папки распределенной файловой системы (DFS). Например, функция NetShareGetInfo может извлекать сведения только для указанного ресурса общей папки на сервере SMB. Чтобы получить сведения о общей папке с помощью другого поставщика сети (например, WebDAV или общего ресурса DFS), используйте функцию WNetGetConnection .

Функция 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.

Функции общего доступа доступны на следующих уровнях информации, хотя некоторые уровни общего доступа применимы только к некоторым функциям общего доступа:

Дополнительные сведения см. в документации по определенной функции общего доступа.

При программировании для Active Directory вы можете вызвать определенные методы интерфейса службы Active Directory (ADSI), чтобы достичь тех же функций, которые можно достичь, вызвав функции общего доступа для управления сетью. Дополнительные сведения см. в разделе IADsFileShare.