Поделиться через

структура SHARE_INFO_2 (lmshare.h)

  • Статья

Содержит сведения об общем ресурсе, включая имя ресурса, тип и разрешения, а также количество текущих подключений. Дополнительные сведения об управлении доступом к защищаемым объектам см. в разделе контроль доступа, привилегии и защищаемые объекты.

Синтаксис

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Члены

shi2_netname

Указатель на строку Юникода, указывающую имя общей папки ресурса. Вызовы функции NetShareSetInfo игнорируют этот элемент.

shi2_type

Сочетание значений, определяющих тип общего ресурса. Вызовы функции NetShareSetInfo игнорируют этот элемент.

Можно указать одно из следующих значений. Эти значения можно изолировать с помощью значения STYPE_MASK .

Значение Значение
STYPE_DISKTREE
 Дисковый накопитель.
STYPE_PRINTQ
 Очередь печати.
STYPE_DEVICE
 Устройство связи.
STYPE_IPC
 Межпроцессная связь (IPC).
 

Кроме того, можно указать одно или оба из следующих значений.

Значение Значение
STYPE_SPECIAL
 Специальный общий ресурс, зарезервированный для межпроцессного взаимодействия (IPC$) или удаленного администрирования сервера (ADMIN$). Также может ссылаться на административные общие папки, такие как C$, D$, E$и т. д. Дополнительные сведения см. в разделе Функции общего сетевого ресурса.
STYPE_TEMPORARY
 Временная общая папка.

shi2_remark

Указатель на строку Юникода, содержащую необязательный комментарий к общему ресурсу.

shi2_permissions

Задает значение DWORD, указывающее разрешения общего ресурса для серверов, работающих с безопасностью на уровне общего доступа. Сервер, на котором выполняется безопасность на уровне пользователя, игнорирует этот элемент. Этот элемент может быть одним или несколькими из следующих значений. Вызовы функции NetShareSetInfo игнорируют этот элемент.

Обратите внимание, что Windows не поддерживает безопасность на уровне общего доступа.

Значение Значение
ACCESS_READ
 Разрешение на чтение данных из ресурса и, по умолчанию, на выполнение ресурса.
ACCESS_WRITE
 Разрешение на запись данных в ресурс.
ACCESS_CREATE
 Разрешение на создание экземпляра ресурса (например, файла); данные могут быть записаны в ресурс по мере его создания.
ACCESS_EXEC
 Разрешение на выполнение ресурса.
ACCESS_DELETE
 Разрешение на удаление ресурса.
ACCESS_ATRIB
 Разрешение на изменение атрибутов ресурса (например, даты и времени последнего изменения файла).
ACCESS_PERM
 Разрешение на изменение разрешений (чтение, запись, создание, выполнение и удаление), назначенных ресурсу для пользователя или приложения.
ACCESS_ALL
 Разрешение на чтение, запись, создание, выполнение и удаление ресурсов, а также на изменение их атрибутов и разрешений.

shi2_max_uses

Задает значение DWORD, указывающее максимальное количество одновременных подключений, которое может разместить общий ресурс. Количество подключений не ограничено, если значение, указанное в этом элементе, равно –1.

shi2_current_uses

Задает значение DWORD, указывающее количество текущих подключений к ресурсу. Вызовы функции NetShareSetInfo игнорируют этот элемент.

shi2_path

Указатель на строку Юникода, указывающую локальный путь к общему ресурсу. Для дисков shi2_path — это общий путь. Для очередей печати shi2_path — это имя очереди печати, к которой предоставлен общий доступ. Вызовы функции NetShareSetInfo игнорируют этот элемент.

shi2_passwd

Указатель на строку Юникода, указывающую пароль общей папки, когда сервер работает с безопасностью на уровне общего ресурса. Если сервер работает с безопасностью на уровне пользователя, этот член игнорируется. Член shi2_passwd может иметь длину не более SHPWLEN+1 байт (включая завершающий символ NULL). Вызовы функции NetShareSetInfo игнорируют этот элемент. Обратите внимание, что Windows не поддерживает безопасность на уровне общего доступа.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть lmshare.h (включая Lm.h)

См. также раздел

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

Общие сведения об управлении сетью

Структуры управления сетью

Функции общих сетевых файлов