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)
無 Access (4)
DeviceNumbers [in]
指定應向啟動器顯示虛擬磁碟的順序。 只有在儲存子系統的 MaskingClientSelectableDeviceNumbers 屬性為 TRUE 時，才能使用這項功能。 如果指定，此參數必須有 1：1 對應與 VirtualDiskNames 參數。
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 參數。 如果已建立記憶體作業來追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。
注意
即使 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 |