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

Статья
08/24/2023

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

Синтаксис

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Члены

shi502_netname

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

shi502_type

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

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

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

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

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

Значение

STYPE_SPECIAL

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

STYPE_TEMPORARY

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

shi502_remark

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

shi502_permissions

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

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

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

shi502_max_uses

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

shi502_current_uses

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

shi502_path

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

shi502_passwd

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

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

shi502_reserved

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

shi502_security_descriptor

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

Требования

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

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

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

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

Функции общего сетевого ресурса