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

另请参阅

操作系统类

Win32_Share