IVdsLunIscsi
COM公式ドキュメント
IVdsLunIscsi インターフェイス (vdshwprv.h) は、iSCSI LUN に対するクエリ操作および構成操作を実行するためのメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
IVdsLunIscsi::AssociateTargets メソッド (vdshwprv.h) は、LUN をサブシステムの iSCSI ターゲットに関連付けます。
| pTargetIdArray | GUID* | in | ターゲットの VDS_OBJECT_ID データ型の配列へのポインター。プロバイダーは、これらの iSCSI ターゲットを LUN に関連付けます。この配列には、引き続き LUN に関連付けたままにする、既に関連付け済みのターゲットも含まれます。 |
| lNumberOfTargets | INT | in | pTargetArray パラメーターで指定されるターゲットの数。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。返される可能性のある値には、次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
|
この戻り値は、アレイに関する情報をキャッシュするプロバイダー内部のソフトウェアまたは通信の問題を示します。キャッシュを復元するには、 IVdsHwProvider::Reenumerate メソッドを実行した後、 IVdsHwProvider::Refresh メソッドを実行してください。 |
|
LUN オブジェクトは既に存在しません。 |
|
LUN が失敗状態にあり、要求された操作を実行できません。 |
|
別の操作が進行中です。この操作は、先行する 1 つまたは複数の操作が完了するまで続行できません。 |
|
VDS_OBJECT_ID 定数を受け取る任意のメソッドから返される可能性があります。この戻り値は、その識別子が既存のオブジェクトを参照していないことを示します。 |
|
この操作、またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。 |
解説(Remarks)
ほとんどのサブシステムでは、LUN ごとに関連付けられるターゲットは 1 つだけですが、複数のターゲットの関連付けを許可するものもあります。
ターゲットの関連付けをクエリするには、 IVdsLunIscsi::QueryAssociatedTargets メソッドを使用してください。ターゲットに関連付けられている LUN をクエリするには、 IVdsIscsiTarget::QueryAssociatedLuns メソッドを使用してください。
IVdsLunIscsi::QueryAssociatedTargets メソッド (vdshwprv.h) は、現在関連付けられている iSCSI ターゲットの列挙を返します。
| ppEnum | IEnumVdsObject** | out | iSCSI ターゲットをターゲットオブジェクトとして列挙するために使用できる IEnumVdsObject インターフェイスポインターのアドレス。詳細については、「列挙オブジェクトの操作」を参照してください。呼び出し元は、インターフェイスおよび各ターゲットオブジェクトが不要になったら、IUnknown::Release メソッドを呼び出して解放する必要があります。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。返される可能性のある値には、次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
|
この戻り値は、アレイに関する情報をキャッシュするプロバイダー内部のソフトウェアまたは通信の問題を示します。キャッシュを復元するには、 IVdsHwProvider::Reenumerate メソッドを実行した後、 IVdsHwProvider::Refresh メソッドを実行してください。 |
|
LUN オブジェクトは既に存在しません。 |
|
LUN が失敗状態にあり、要求された操作を実行できません。 |
|
別の操作が進行中です。この操作は、先行する 1 つまたは複数の操作が完了するまで続行できません。 |
解説(Remarks)
ほとんどのサブシステムでは、LUN ごとに関連付けられるターゲットは 1 つだけですが、複数のターゲットの関連付けを許可するものもあります。
ターゲットを関連付けるには、IVdsLunIscsi::AssociateTargets メソッドを使用してください。ターゲットに関連付けられている LUN をクエリするには、 IVdsIscsiTarget::QueryAssociatedLuns メソッドを使用してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IVdsLunIscsi "{0D7C1E64-B59B-45AE-B86A-2C2CC6A42067}" #usecom global IVdsLunIscsi IID_IVdsLunIscsi "{}" #comfunc global IVdsLunIscsi_AssociateTargets 3 var,int #comfunc global IVdsLunIscsi_QueryAssociatedTargets 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsLunIscsi "{0D7C1E64-B59B-45AE-B86A-2C2CC6A42067}" #usecom global IVdsLunIscsi IID_IVdsLunIscsi "{}" #comfunc global IVdsLunIscsi_AssociateTargets 3 sptr,int #comfunc global IVdsLunIscsi_QueryAssociatedTargets 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。