ホーム › Storage.VirtualDiskService › IVdsHbaPort
IVdsHbaPort
COM公式ドキュメント
ローカルシステム上のHBAポートを照会し、操作するためのメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT GetProperties(VDS_HBAPORT_PROP* pHbaPortProp)
HBAポートのプロパティを取得します。
| pHbaPortProp | VDS_HBAPORT_PROP* | out | 呼び出し元によって割り当てられて渡される VDS_HBAPORT_PROP 構造体のメンバーのアドレス。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返す場合もあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダー から発生する可能性があります。戻り値には次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
| プロパティが正常に返されました。 | |
|
一部のプロパティは正常に取得されましたが、すべてではありません。すべてのプロパティの取得に失敗する原因は、デバイスの取り外しなど、数多く考えられる点に注意してください。 |
| pHbaPortProp パラメーターが有効なポインターではありません。 |
vtbl 4 HRESULT SetAllPathStatuses(VDS_PATH_STATUS status)
HBAポートを起点とするすべてのパスのステータスを、指定されたステータスに設定します。
| status | VDS_PATH_STATUS | in | パスに割り当てるステータス。 |
戻り値
このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値 を返すことがあります。また、HRESULT_FROM_WIN32 マクロを使用して変換された システムエラーコード を返す場合もあります。エラーは、VDS 自体、または使用されている基盤の VDS プロバイダー から発生する可能性があります。戻り値には次のものが含まれます。
| リターンコード/値 | 説明 |
|---|---|
| ステータスが正常に設定されました。 | |
|
致命的でないエラー(たとえば、ステータスが現在の負荷分散ポリシーと競合する場合など)により、少なくとも1つのパスのステータスが正常に設定されませんでした。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IVdsHbaPort "{2ABD757F-2851-4997-9A13-47D2A885D6CA}" #usecom global IVdsHbaPort IID_IVdsHbaPort "{}" #comfunc global IVdsHbaPort_GetProperties 3 var #comfunc global IVdsHbaPort_SetAllPathStatuses 4 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IVdsHbaPort "{2ABD757F-2851-4997-9A13-47D2A885D6CA}" #usecom global IVdsHbaPort IID_IVdsHbaPort "{}" #comfunc global IVdsHbaPort_GetProperties 3 sptr #comfunc global IVdsHbaPort_SetAllPathStatuses 4 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。