Win32 API 日本語リファレンス
ホーム › Networking.NetworkListManager › INetworkConnectionEvents

INetworkConnectionEvents

COM
📘 Microsoft Learn (日本語) · English
IIDdcb00007-570f-4a9b-8d69-199fdba5723b継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

INetworkConnectionEvents インターフェイスは、クライアントがネットワーク接続関連のイベントを受け取るために実装するメッセージシンクインターフェイスです。認証の変更などの下位レベルのイベントに関心があるアプリケーションは、このインターフェイスを実装する必要があります。

メソッド 2

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

vtbl 3 HRESULT NetworkConnectionConnectivityChanged(GUID connectionId, NLM_CONNECTIVITY newConnectivity)

NetworkConnectionConnectivityChanged メソッドは、ネットワーク接続レベルで接続性の変更イベントが発生したときにクライアントに通知します。

connectionIdGUIDinイベントが発生したネットワーク接続を識別する GUID です。
newConnectivityNLM_CONNECTIVITYinこのネットワーク接続の新しい接続性を指定する NLM_CONNECTIVITY 列挙値です。

戻り値

メソッドが成功した場合は S_OK を返します。

vtbl 4 HRESULT NetworkConnectionPropertyChanged(GUID connectionId, NLM_CONNECTION_PROPERTY_CHANGE flags)

NetworkConnectionPropertyChanged メソッドは、特定のネットワーク接続に関連するプロパティ変更イベントが発生したときにクライアントに通知します。

connectionIdGUIDinイベントが発生したネットワーク接続を識別する GUID です。
flagsNLM_CONNECTION_PROPERTY_CHANGEinこの接続の NLM_CONNECTION_PROPERTY_CHANGE フラグです。

戻り値

メソッドが成功した場合は S_OK を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetworkConnectionEvents "{DCB00007-570F-4A9B-8D69-199FDBA5723B}"
#usecom global INetworkConnectionEvents IID_INetworkConnectionEvents "{}"
#comfunc global INetworkConnectionEvents_NetworkConnectionConnectivityChanged  3 int,int
#comfunc global INetworkConnectionEvents_NetworkConnectionPropertyChanged      4 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。