通过

MSFT_StorageSubSystem 类的 CreateMaskingSet 方法

  • 项目

创建新的屏蔽集。

掩码集是虚拟磁盘、目标端口和发起程序逻辑分组，用于向主机显示虚拟磁盘

语法

UInt32 CreateMaskingSet(
  [in]  String              FriendlyName,
  [in]  String              VirtualDiskNames[],
  [in]  UInt16              DeviceAccesses[],
  [in]  String              DeviceNumbers[],
  [in]  String              TargetPortAddresses[],
  [in]  String              InitiatorAddresses[],
  [in]  UInt16              HostType,
  [in]  Boolean             RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              CreatedMaskingSet,
  [out] String              ExtendedStatus
);

参数

FriendlyName [in]

掩码集的友好名称。

友好名称应具有描述性，但它们不一定是唯一的。

此参数是必需的，不能为 NULL。

VirtualDiskNames [in]

要向掩码集中的发起程序显示的虚拟磁盘列表。 每个磁盘必须由存储在其 MSFT_VirtualDisk 对象的 Name 属性中的标识符指定

此参数具有 DeviceAccesses 参数的 1：1 映射。 两个数组的长度必须相同，并且元素必须按相同的顺序排列。

DeviceAccesses [in]

发起程序应对 VirtualDiskNames 参数中指定的每个虚拟磁盘的访问级别。 此参数具有 VirtualDiskNames 参数的 1：1 映射。 两个数组的长度必须相同，并且元素必须按相同的顺序排列。

未知 (0)

读取写入 (2)

只读 (3)

无访问 (4)

DeviceNumbers [in]

指定虚拟磁盘应向发起方显示的顺序。 仅当存储子系统的 MaskingClientSelectableDeviceNumbers 属性为 TRUE 时，此功能才可用。 如果指定，此参数必须具有 VirtualDiskNames 参数的 1：1 映射。

TargetPortAddresses [in]

向发起方显示虚拟磁盘时要使用的目标端口。 可指定的目标端口数取决于子系统的 MaskingPortsPerView 属性。 如果 MaskingPortsPerView 是 所有目标端口共享同一视图，则忽略此参数，并且系统上的所有目标端口都与此掩码集相关联。

InitiatorAddresses [in]

应向其显示虚拟磁盘的发起程序。 如果子系统的 MaskingOneInitiatorIdPerView 属性为 TRUE，则只能为此掩码集指定一个发起程序。 有效发起程序地址格式的列表由子系统的 MaskingValidInitiatorIdTypes 属性指定。

HostType [in]

主机操作系统或其他主机环境因素，可能会影响存储系统在向发起程序显示虚拟磁盘时应具有的行为。

介于 22 和 32767 (（含) ）之间的值保留给 DMTF。 32768 到 65535 (非独占) 的值保留给供应商。

未知 (0)

其他 (1)

标准 (2)

Solaris (3)

HPUX (4)

OpenVMS (5)

Tru64 (6)

Netware (7)

Sequent (8)

AIX (9)

DGUX (10)

Dynix (11)

Irix (12)

Cisco iSCSI 存储路由器 (13)

Linux (14)

Microsoft Windows (15)

OS400 (16)

TRESPASS (17)

HI-UX (18)

VMware ESXi (19)

Microsoft Windows Server 2008 (20)

Microsoft Windows Server 2003 (21)

DMTF 保留 (22..32767)

供应商特定 (32768..65535)

RunAsJob [in]

如果 为 TRUE，则当请求需要很长时间才能提供服务时，此方法使用 CreatedStorageJob 参数。 如果已创建存储作业来跟踪操作，此方法将返回 方法参数 Checked - 作业启动。

注意

即使 RunAsJob 为 TRUE，此方法仍可返回结果（如果已完成足够时间）。

如果 为 FALSE 或 NULL，此方法将遵循客户端的调用方法确定的默认 WMI 异步行为。 换句话说，除非另有请求，否则它是同步的。

CreatedStorageJob [out]

如果 RunAsJob 设置为 TRUE 并且此方法执行时间较长，则此参数将接收对用于跟踪长时间运行的操作的存储作业对象的引用。

CreatedMaskingSet [out]

如果成功创建掩码集，此参数将接收包含嵌入 MSFT_MaskingSet 对象的字符串。

ExtendedStatus [out]

包含嵌入 MSFT_StorageExtendedStatus 对象的字符串。

此参数允许存储提供程序返回特定于实现的扩展 () 错误信息。

返回值

成功 (0)

不支持 (1)

未指定的错误 (2)

超时 (3)

失败 (4)

参数 (5) 无效

方法参数已选中 - 作业已启动 (4096)

拒绝访问 (40001)

没有足够的资源来完成操作。 (40002)

无法连接到存储提供程序。 (46000)

存储提供程序无法连接到存储子系统。 (46001)

找不到指定的虚拟磁盘。 (50000)

指定的设备编号无效。 (52000)

不支持请求的 HostType。 (52001)

必须为每个虚拟磁盘指定 DeviceAccess。 (52002)

指定的发起方地址无效 (53000)

此操作只能接受一个发起方地址。 (53001)

指定的目标端口地址无效。 (54000)

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另请参阅

MSFT_StorageSubSystem