Win32_Share 类的 SetShareInfo 方法

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)

(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
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

操作系统类

Win32_Share