ホーム › Storage.VirtualDiskService › IVdsIscsiInitiatorPortal

IVdsIscsiInitiatorPortal

COM

📘 Microsoft Learn (日本語) · English

IID38a0a9ab-7cc8-4693-ac07-1f28bd03c3da継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ローカルシステム上の iSCSI イニシエーターポータルを照会および操作するためのメソッドを提供します。

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetProperties(VDS_ISCSI_INITIATOR_PORTAL_PROP* pInitiatorPortalProp)

イニシエーターポータルのプロパティを返します。

pInitiatorPortalProp

VDS_ISCSI_INITIATOR_PORTAL_PROP*

out

呼び出し元が割り当てた VDS_ISCSI_INITIATOR_PORTAL_PROP 構造体のアドレス。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことができます。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものが含まれます。

戻り値/値	説明
S_OK	プロパティが正常に返されました。
VDS_S_PROPERTIES_INCOMPLETE 0x00042715L	一部のプロパティは取得できましたが、すべては取得できませんでした。すべてのプロパティの取得に失敗する原因は、デバイスの取り外しなど、数多く考えられる点に注意してください。

vtbl 4 HRESULT GetInitiatorAdapter(IVdsIscsiInitiatorAdapter** ppInitiatorAdapter)

イニシエーターポータルが属するイニシエーターアダプターを返します。

ppInitiatorAdapter

IVdsIscsiInitiatorAdapter**

out

IVdsIscsiInitiatorAdapter インターフェイスポインターのアドレス。VDS は戻り時にインターフェイスを初期化します。呼び出し元はインターフェイスを解放する必要があります。

戻り値

戻り値	説明
S_OK	イニシエーターアダプターが正常に返されました。

vtbl 5 HRESULT SetIpsecTunnelAddress(VDS_IPADDRESS* pTunnelAddress, VDS_IPADDRESS* pDestinationAddress)

サポートされていません。このメソッドは将来の使用のために予約されています。(IVdsIscsiInitiatorPortal.SetIpsecTunnelAddress)

pTunnelAddress	VDS_IPADDRESS*	in	将来の使用のために予約されています。
pDestinationAddress	VDS_IPADDRESS*	in	将来の使用のために予約されています。

戻り値

このメソッドは次のいずれかの値を返すことができます。

戻り値	説明
VDS_E_NOT_SUPPORTED	このメソッドはこのリリースではサポートされていません。

vtbl 6 HRESULT GetIpsecSecurity(GUID targetPortalId, ULONGLONG* pullSecurityFlags)

サポートされていません。このメソッドは将来の使用のために予約されています。(IVdsIscsiInitiatorPortal.GetIpsecSecurity)

targetPortalId	GUID	in	将来の使用のために予約されています。
pullSecurityFlags	ULONGLONG*	out	将来の使用のために予約されています。

戻り値

このメソッドは次のいずれかの値を返すことができます。

戻り値	説明
VDS_E_NOT_SUPPORTED	このメソッドはこのリリースではサポートされていません。

vtbl 7 HRESULT SetIpsecSecurity(GUID targetPortalId, ULONGLONG ullSecurityFlags, VDS_ISCSI_IPSEC_KEY* pIpsecKey)

サポートされていません。このメソッドは将来の使用のために予約されています。(IVdsIscsiInitiatorPortal.SetIpsecSecurity)

targetPortalId	GUID	in	将来の使用のために予約されています。
ullSecurityFlags	ULONGLONG	in	将来の使用のために予約されています。
pIpsecKey	VDS_ISCSI_IPSEC_KEY*	in	将来の使用のために予約されています。

戻り値

このメソッドは次のいずれかの値を返すことができます。

戻り値	説明
VDS_E_NOT_SUPPORTED	このメソッドはこのリリースではサポートされていません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IVdsIscsiInitiatorPortal "{38A0A9AB-7CC8-4693-AC07-1F28BD03C3DA}"
#usecom global IVdsIscsiInitiatorPortal IID_IVdsIscsiInitiatorPortal "{}"
#comfunc global IVdsIscsiInitiatorPortal_GetProperties          3 var
#comfunc global IVdsIscsiInitiatorPortal_GetInitiatorAdapter    4 sptr
#comfunc global IVdsIscsiInitiatorPortal_SetIpsecTunnelAddress  5 var,var
#comfunc global IVdsIscsiInitiatorPortal_GetIpsecSecurity       6 int,var
#comfunc global IVdsIscsiInitiatorPortal_SetIpsecSecurity       7 int,int64,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsIscsiInitiatorPortal "{38A0A9AB-7CC8-4693-AC07-1F28BD03C3DA}"
#usecom global IVdsIscsiInitiatorPortal IID_IVdsIscsiInitiatorPortal "{}"
#comfunc global IVdsIscsiInitiatorPortal_GetProperties          3 sptr
#comfunc global IVdsIscsiInitiatorPortal_GetInitiatorAdapter    4 sptr
#comfunc global IVdsIscsiInitiatorPortal_SetIpsecTunnelAddress  5 sptr,sptr
#comfunc global IVdsIscsiInitiatorPortal_GetIpsecSecurity       6 int,sptr
#comfunc global IVdsIscsiInitiatorPortal_SetIpsecSecurity       7 int,int64,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。