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

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

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

Функция Описание
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.