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

Статья
08/24/2023

Содержит сведения об общем ресурсе. Он идентичен структуре SHARE_INFO_502 , за исключением того, что он также содержит имя сервера.

Синтаксис

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Члены

shi503_netname

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

shi503_type

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

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

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

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

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

Значение

STYPE_SPECIAL
0x80000000

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

STYPE_TEMPORARY
0x40000000

Временная общая папка.

shi503_remark

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

shi503_permissions

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

Вызовы функции NetShareSetInfo игнорируют этот элемент.

Этот член может быть любым из следующих значений.

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

shi503_max_uses

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

shi503_current_uses

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

shi503_path

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

shi503_passwd

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

Этот член не может быть длиннее SHPWLEN+1 байт (включая завершающий символ NULL). Вызовы функции NetShareSetInfo игнорируют этот элемент.

shi503_servername

Указатель на строку, указывающую DNS или NetBIOS-имя удаленного сервера, на котором находится общий ресурс. Значение "*" указывает на отсутствие настроенного имени сервера.

shi503_reserved

Защищены; значение должно быть равно нулю. Вызовы функции NetShareSetInfo игнорируют этот элемент.

shi503_security_descriptor

Указывает SECURITY_DESCRIPTOR , связанные с этой общей папкой.

Удаленный сервер, указанный в элементе shi503_servername , должен быть привязан к транспортному протоколу с помощью функции NetServerTransportAddEx . В вызове NetServerTransportAddEx для параметра level должно быть указано значение 2 или 3, а значение SVTI2_SCOPED_NAME должно быть указано в структуре SERVER_TRANSPORT_INFO_2 транспортного протокола.

Требования


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