Win32_Share 类的 SetShareInfo 方法
SetShareInfoWMI 类方法设置共享资源的参数。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 SetShareInfo(
[in, optional] uint32 MaximumAllowed,
[in, optional] string Description,
[in, optional] Win32_SecurityDescriptor Access
);
参数
-
MaximumAllowed [in， optional]
-
限制允许并发使用此资源的最大用户数。
示例：10。 此参数可选。
-
说明 [in， 可选]
-
描述正在共享的资源的可选注释。
-
Access [in， optional]
-
用户级权限的安全描述符。 安全描述符包含有关资源的权限、所有者和访问权限的信息。 有关详细信息，请参阅 Win32_SecurityDescriptor。
返回值
返回以下列表中列出的值之一或指示错误的任何其他值之一。
-
成功 (0)
-
访问被拒绝 (2)
-
未知故障 (8)
-
名称 (9) 无效
-
级别 (10) 无效
-
参数 (21) 无效
-
重复共享 (22)
-
重定向的路径 (23)
-
未知设备或目录 (24)
-
25) (找不到净名称
-
其他 (26 4294967295)
备注
SetShareInfo 方法是一种动态对象方法，用于此类的出现。
只有管理员或帐户操作员本地组的成员或具有通信、打印或服务器操作员组成员身份的成员才能成功执行 SetShareInfo。 打印操作员只能设置打印机队列。 通信操作员只能设置通信设备队列。
示例
以下 PowerShell 示例更新 newShare 共享的名称。
$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 |
|
| DLL |
|