Метод SetShareInfo класса Win32_Share

Статья
06/12/2023

Метод класса SetShareInfoWMI задает параметры общего ресурса.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

Параметры

MaximumAllowed [in, необязательный]

Ограничьте максимальное число пользователей, которым разрешено использовать этот ресурс одновременно.

Пример: 10. Этот параметр является необязательным.

Описание [in, необязательно]

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

Access [in, необязательный]

Дескриптор безопасности для разрешений на уровне пользователя. Дескриптор безопасности содержит сведения о разрешениях, владельцах и возможностях доступа ресурса. Дополнительные сведения см. в разделе Win32_SecurityDescriptor.

Возвращаемое значение

Возвращает одно из значений, перечисленных в следующем списке, или любое другое значение, указывающее на ошибку.

Успешное выполнение (0)
Доступ запрещен (2)
Неизвестный сбой (8)
Недопустимое имя (9)
Недопустимый уровень (10)
Недопустимый параметр (21)
Дублировать общий ресурс (22)
Перенаправленный путь (23)
Неизвестное устройство или каталог (24)
Net name not found (25)
Другое (26 4294967295)

Только члены локальной группы "Администраторы" или "Операторы учетных записей" или члены группы операторов "Связь", "Печать" или "Сервер" могут успешно выполнять SetShareInfo. Оператор печати может задавать только очереди принтера. Оператор связи может задавать только очереди устройств связи.

Примеры

В следующем примере PowerShell обновляется имя новой общей папки Share.

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

Классы операционной системы
Win32_Share