ホーム › NetworkManagement.WiFi › IDot11AdHocManagerNotificationSink

IDot11AdHocManagerNotificationSink

COM

📘 Microsoft Learn (日本語) · English

IID8f10cc27-cf0d-42a0-acbe-e2de7007384d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IDot11AdHocManager インターフェイスがサポートする通知を定義します。

メソッド 4

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

vtbl 3 HRESULT OnNetworkAdd(IDot11AdHocNetwork* pIAdHocNetwork)

新しいワイヤレスアドホックネットワークの接続先が通信範囲内に入り、接続可能になったことをクライアントに通知します。

pIAdHocNetwork

IDot11AdHocNetwork*

新しいネットワークを表す IDot11AdHocNetwork インターフェイスへのポインターです。

戻り値

戻り値には、以下のものが含まれます (ただしこれらに限定されません)。

戻り値	説明
S_OK	メソッドは正常に完了しました。
E_FAIL	メソッドは失敗しました。

vtbl 4 HRESULT OnNetworkRemove(GUID* Signature)

ワイヤレスアドホックネットワークの接続先が接続できなくなったことをクライアントに通知します。

Signature

GUID*

接続できなくなったネットワークを一意に識別するシグネチャへのポインターです。シグネチャの詳細については、IDot11AdHocNetwork::GetSignature を参照してください。

戻り値

戻り値には、以下のものが含まれます (ただしこれらに限定されません)。

戻り値	説明
S_OK	メソッドは正常に完了しました。
E_FAIL	メソッドは失敗しました。

vtbl 5 HRESULT OnInterfaceAdd(IDot11AdHocInterface* pIAdHocInterface)

新しいネットワークインターフェイスカード (NIC) がアクティブになったことをクライアントに通知します。

pIAdHocInterface

IDot11AdHocInterface*

アクティブになった NIC を表す IDot11AdHocInterface インターフェイスへのポインターです。

戻り値

戻り値には、以下のものが含まれます (ただしこれらに限定されません)。

戻り値	説明
S_OK	メソッドは正常に完了しました。
E_FAIL	メソッドは失敗しました。

vtbl 6 HRESULT OnInterfaceRemove(GUID* Signature)

ネットワークインターフェイスカード (NIC) が非アクティブになったことをクライアントに通知します。

Signature

GUID*

非アクティブになった NIC を一意に識別するシグネチャへのポインターです。シグネチャの詳細については、IDot11AdHocInterface::GetDeviceSignature を参照してください。

戻り値

戻り値には、以下のものが含まれます (ただしこれらに限定されません)。

戻り値	説明
S_OK	メソッドは正常に完了しました。
E_FAIL	メソッドは失敗しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDot11AdHocManagerNotificationSink "{8F10CC27-CF0D-42A0-ACBE-E2DE7007384D}"
#usecom global IDot11AdHocManagerNotificationSink IID_IDot11AdHocManagerNotificationSink "{}"
#comfunc global IDot11AdHocManagerNotificationSink_OnNetworkAdd       3 sptr
#comfunc global IDot11AdHocManagerNotificationSink_OnNetworkRemove    4 var
#comfunc global IDot11AdHocManagerNotificationSink_OnInterfaceAdd     5 sptr
#comfunc global IDot11AdHocManagerNotificationSink_OnInterfaceRemove  6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDot11AdHocManagerNotificationSink "{8F10CC27-CF0D-42A0-ACBE-E2DE7007384D}"
#usecom global IDot11AdHocManagerNotificationSink IID_IDot11AdHocManagerNotificationSink "{}"
#comfunc global IDot11AdHocManagerNotificationSink_OnNetworkAdd       3 sptr
#comfunc global IDot11AdHocManagerNotificationSink_OnNetworkRemove    4 sptr
#comfunc global IDot11AdHocManagerNotificationSink_OnInterfaceAdd     5 sptr
#comfunc global IDot11AdHocManagerNotificationSink_OnInterfaceRemove  6 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。