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

Метод CreateWMI class инициирует общий доступ к ресурсу сервера.

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

Синтаксис

uint32 Create(
  [in]           string                   Path,
  [in]           string                   Name,
  [in]           uint32                   Type,
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] string                   Password,
  [in, optional] Win32_SecurityDescriptor Access
);

Параметры

Путь [in]

Локальный путь к общей папке Windows.

Пример: "C:\Program Files".

Имя [in]

Передает псевдоним в путь, настроенный в качестве общей папки на компьютере под управлением Windows.

Пример: "public".

Введите [in]

Передает тип ресурса, к которым предоставляется общий доступ. К типам относятся диски, очереди печати, межпроцессные коммуникации (IPC) и устройства общего назначения. Может иметь одно из следующих значений.

Диск (0)

Очередь печати (1)

Устройство (2)

IPC (3)

Администратор диска (2147483648)

Администратор очереди печати (2147483649)

Администратор устройства (2147483650)

IPC Администратор (2147483651)

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

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

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

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

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

Пароль [в, необязательно]

Пароль (если сервер работает с безопасностью на уровне общего ресурса) для общего ресурса. Если сервер работает с безопасностью на уровне пользователя, этот параметр игнорируется. Этот параметр является необязательным.

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

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

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

Возвращает одно из значений, перечисленных в следующем списке, или любое другое значение, указывающее на ошибку. Дополнительные коды ошибок см. в разделе WMI Error Constants или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешное выполнение (0)

Доступ запрещен (2)

Неизвестный сбой (8)

Недопустимое имя (9)

Недопустимый уровень (10)

Недопустимый параметр (21)

Дублировать общий ресурс (22)

Перенаправленный путь (23)

Неизвестное устройство или каталог (24)

Net name not found (25)

Другое (26 4294967295)

Комментарии

Create — это статический метод.

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

Примеры

В примере PowerShell для экспорта и импорта общих папок выполняется экспорт и импорт общих папок, а также задаются разрешения для общих папок. Аналогичным образом, в примере Create a Share and Set Permissions (Создание общего ресурса и настройка разрешений ) также создается новая общая папка и задаются разрешения на доступ к общей папке.

Следующий код PowerShell создает общую папку.

# create pointer to class
$comp=[WMICLASS]"Win32_share"

# create a new share
$comp.create("c:\","mynewshare",0)

# see results
gwmi win32_share 

Предыдущий пример кода возвращает следующее:

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     : 
__DYNASTY        : __PARAMETERS
__RELPATH        : 
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         : 
__NAMESPACE      : 
__PATH           : 
ReturnValue      : 2
PSComputerName   : 

Name        : ADMIN$
Path        : C:\Windows
Description : Remote Admin

Name        : C$
Path        : C:\
Description : Default share

Name        : CCMLOGS$
Path        : C:\Windows\CCM\Logs
Description : Public Share

Name        : ccmsetup$
Path        : C:\Windows\ccmsetup
Description : Public Share

Name        : Drop
Path        : C:\Drop
Description : 

Name        : IPC$
Path        : 
Description : Remote IPC

Name        : Share
Path        : C:\Share
Description : 

В следующем примере кода C# описывается вызов метода create.

private static void makeShare(string servername, string filepath, string sharename)
{
try
 {
 // assemble the string so the scope represents the remote server
 string scope = string.Format("\\\\{0}\\root\\cimv2", servername);

 // connect to WMI on the remote server
 ManagementScope ms = new ManagementScope(scope);

 // create a new instance of the Win32_Share WMI object
 ManagementClass cls = new ManagementClass("Win32_Share");

 // set the scope of the new instance to that created above
 cls.Scope = ms;

 // assemble the arguments to be passed to the Create method
 object[] methodargs = { filepath, sharename, "0" };

 // invoke the Create method to create the share
 object result = cls.InvokeMethod("Create", methodargs);
 }
catch (SystemException e)
 {
  Console.WriteLine("Error attempting to create share {0}:", sharename);
  Console.WriteLine(e.Message);
 }

}

Требования

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

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

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

Win32_Share