MSFT_MaskingSet 類別的 AddInitiatorId 方法

將一或多個啟動器標識元新增至遮罩集。

遮罩集中的所有虛擬磁碟都將可供存取, (這些啟動器會顯示) 。

語法

UInt32 AddInitiatorId(
  [in]  String                  InitiatorIds[],
  [in]  UInt16                  HostType,
  [in]  Boolean                 RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String                  ExtendedStatus
);

參數

InitiatorIds [in]

包含啟動器位址的字串數位。 針對這個陣列中包含的每個位址,應該建立對應的 MSFT_InitiatorId 實例,然後使用 MSFT_MaskingSetToInitiatorId 類別與此遮罩集建立關聯。

這個參數是必要的,而且不能是 NULL。

HostType [in]

主機操作系統或其他可能會影響記憶體系統對啟動器顯示虛擬磁碟時應該具備的行為的主機操作系統或其他主機環境因素。

未知 (0)

標準 (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)

Microsoft 保留 (22..32767)

廠商特定 (32768..65535)

RunAsJob [in]

此參數會控制方法將遵循的異步行為。

TRUE 表示當要求需要很長的時間才能服務時,使用 CreatedStorageJob out 參數;否則 為 FALSE

如果已建立記憶體作業來追蹤作業,這個方法會傳回 4096 - 「已檢查的方法參數 - 作業已啟動」。 請注意,即使 RunAsJobTRUE,如果方法在足夠時間內完成,仍可傳回結果。

如果 為 FALSENULL,除非另有要求,否則此方法會遵循用戶端的 叫用方法所決定的預設 WMI 異步行為 (,亦即,除非另有要求) ,否則為同步。

CreatedStorageJob [out]

如果 RunAsJob 設定為 TRUE ,且此方法需要一段時間才能執行,此參數會傳回用來追蹤長時間執行作業的記憶體作業參考。

ExtendedStatus [out]

包含內嵌 MSFT_StorageExtendedStatus 物件的字串。

此參數可讓記憶體提供者傳回擴充 (實作特定) 錯誤資訊。

傳回值

成功 (0)

不支援 (1)

未指定的錯誤 (2)

時 (3)

失敗 (4)

無效的參數 (5)

拒絕存取 (40001)

沒有足夠的資源來完成作業。 (40002)

無法連線到記憶體提供者。 (46000)

記憶體提供者無法連線到記憶體子系統。 (46001)

指定的啟動器地址無效 , (53000)

此作業只能接受一個啟動器位址。 (53001)

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
命名空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另請參閱

MSFT_MaskingSet