ホーム › NetworkManagement.WindowsFirewall › INetConnectionProps

INetConnectionProps

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDf4277c95-ce5b-463d-8167-5662d9bcaa72継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

接続のプロパティを取得するには、INetConnectionProps インターフェイスを使用します。

メソッド 6

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Guid(LPWSTR* pbstrGuid)

get_Guid メソッドは、接続のグローバル一意識別子 (GUID) を取得します。

pbstrGuid

LPWSTR*

out

BSTR 変数へのポインター。正常に戻ると、接続の GUID を受け取ります。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

vtbl 8 HRESULT get_Name(LPWSTR* pbstrName)

get_Name メソッドは、接続の名前を取得します。

pbstrName

LPWSTR*

out

BSTR 変数へのポインター。正常に戻ると、接続の名前を受け取ります。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

vtbl 9 HRESULT get_DeviceName(LPWSTR* pbstrDeviceName)

get_DeviceName メソッドは、接続に関連付けられたデバイスの名前を取得します。

pbstrDeviceName

LPWSTR*

out

BSTR 変数へのポインター。正常に戻ると、接続に関連付けられたデバイスの名前を受け取ります。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

vtbl 10 HRESULT get_Status(NETCON_STATUS* pStatus)

get_Status メソッドは、接続の状態を取得します。

pStatus

NETCON_STATUS*

out

NETCON_STATUS 型の変数へのポインター。正常に戻ると、接続の状態を示すコードを受け取ります。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

vtbl 11 HRESULT get_MediaType(NETCON_MEDIATYPE* pMediaType)

get_MediaType メソッドは、接続のメディアの種類を取得します。

pMediaType

NETCON_MEDIATYPE*

out

NETCON_MEDIATYPE 型の変数へのポインター。正常に戻ると、接続のメディアの種類を示すコードを受け取ります。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

vtbl 12 HRESULT get_Characteristics(DWORD* pdwFlags)

get_Characteristics メソッドは、接続のメディアの種類を取得します。

pdwFlags

DWORD*

out

NETCON_MEDIATYPE で定義されるメディアの種類。

戻り値

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードです。

戻り値	説明
E_ABORT	操作が中止されました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	いずれかのパラメーターが無効です。
E_NOINTERFACE	指定されたインターフェイスはサポートされていません。
E_NOTIMPL	指定されたメソッドは実装されていません。
E_OUTOFMEMORY	メソッドは必要なメモリを割り当てられませんでした。
E_POINTER	パラメーターとして渡されたポインターが無効です。
E_UNEXPECTED	不明な理由でメソッドが失敗しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetConnectionProps "{F4277C95-CE5B-463D-8167-5662D9BCAA72}"
#usecom global INetConnectionProps IID_INetConnectionProps "{}"
#comfunc global INetConnectionProps_get_Guid             7 var
#comfunc global INetConnectionProps_get_Name             8 var
#comfunc global INetConnectionProps_get_DeviceName       9 var
#comfunc global INetConnectionProps_get_Status           10 var
#comfunc global INetConnectionProps_get_MediaType        11 var
#comfunc global INetConnectionProps_get_Characteristics  12 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_INetConnectionProps "{F4277C95-CE5B-463D-8167-5662D9BCAA72}"
#usecom global INetConnectionProps IID_INetConnectionProps "{}"
#comfunc global INetConnectionProps_get_Guid             7 sptr
#comfunc global INetConnectionProps_get_Name             8 sptr
#comfunc global INetConnectionProps_get_DeviceName       9 sptr
#comfunc global INetConnectionProps_get_Status           10 sptr
#comfunc global INetConnectionProps_get_MediaType        11 sptr
#comfunc global INetConnectionProps_get_Characteristics  12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。