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 のマッピングがあります。 両方の配列は同じ長さである必要があり、要素は同じ順序で配置する必要があります。
Unknown (0)
Read Write (2)
Read-Only (3)
No Access (4)
DeviceNumbers [in]
仮想ディスクをイニシエーターに表示する順序を指定します。 この機能は、ストレージ サブシステムの MaskingClientSelectableDeviceNumbers プロパティが TRUE の場合にのみ使用できます。 指定された場合、このパラメーターは VirtualDiskNames パラメーターと 1:1 のマッピングが必要です。
TargetPortAddresses [in]
イニシエーターに仮想ディスクを表示するときに使用するターゲット ポート。 指定できるターゲット ポートの数は、サブシステムの MaskingPortsPerView プロパティによって異なります。 MaskingPortsPerView が [すべてのターゲット ポートが同じビューを共有する] の場合、このパラメーターは無視され、システム上のすべてのターゲット ポートが個のマスキング セットに関連付けられます。
InitiatorAddresses [in]
仮想ディスクが表示されるイニシエーター。 サブシステムの MaskingOneInitiatorIdPerView プロパティが TRUE の場合、このマスキング セットに指定できるイニシエーターは 1 つだけです。 有効なイニシエーター アドレス形式のリストは、サブシステムの MaskingValidInitiatorIdTypes プロパティによって指定されます。
HostType [in]
仮想ディスクをイニシエーターに表示するときにストレージ システムが持つ必要がある動作に影響する可能性があるホスト オペレーティング システムまたはその他のホスト環境要因。
22 ~ 32767 (両端を含む) の値は DMTF 用に予約されています。 32768 ~ 65535 (両端を含む) の値は、ベンダー向けに予約されています。
Unknown (0)
Other (1)
Standard (2)
Solaris (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
Sequent (8)
AIX (9)
DGUX (10)
Dynix (11)
Irix (12)
Cisco iSCSI Storage Router (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 Reserved (22..32767)
Vendor Specific (32768..65535)
RunAsJob [in]
TRUE の場合、このメソッドは、要求のサービスに時間がかかっているときに CreatedStorageJob パラメーターを使用します。 操作を追跡するためにストレージ ジョブが作成されている場合、このメソッドは Method Parameters Checked - Job Started を返します。
Note
RunAsJob が TRUE の場合でも、十分な時間内に終了していれば、このメソッドは結果を返すことができます。
FALSE または NULL の場合、このメソッドは、クライアントの呼び出し方法によって決定される既定の WMI の非同期動作に従います。 つまり、特に要求されない限りは同期です。
CreatedStorageJob [out]
RunAsJob が TRUE に設定されていて、このメソッドの実行に時間がかかる場合、このパラメーターは、実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を受け取ります。
CreatedMaskingSet [out]
マスキング セットが正常に作成されると、このパラメーターは埋め込み MSFT_MaskingSet オブジェクトを含む文字列を受け取ります。
ExtendedStatus [out]
埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。
このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。
戻り値
Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Method Parameters Checked - Job Started (4096)
Access denied (40001)
リソース不足のため、操作を完了できません。 (40002)
ストレージ プロバイダーに接続できません。 (46000)
ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)
指定された仮想ディスクが見つかりませんでした。 (50000)
指定されたデバイス番号が無効です。 (52000)
要求された HostType はサポートされていません。 (52001)
DeviceAccess は、仮想ディスクごとに指定する必要があります。 (52002)
指定されたイニシエーター アドレスが無効です (53000)
この操作で許容できるイニシエーター アドレスは 1 つだけです。 (53001)
指定されたターゲット ポート アドレスは無効です。 (54000)
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |