ホーム › NetworkManagement.WiFi › IDot11AdHocInterface
IDot11AdHocInterface
COM公式ドキュメント
ワイヤレスネットワークインターフェイスカード (NIC) を表します。
メソッド 9
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT GetDeviceSignature(GUID* pSignature)
NIC のシグネチャを取得します。
| pSignature | GUID* | inout | NIC のシグネチャ。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
NIC のフレンドリ名を取得します。
| ppszName | LPWSTR* | out | NIC のフレンドリ名。ネットワークの SSID がフレンドリ名として使用されます。 この文字列は CoTaskMemFree を使用して解放する必要があります。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
NIC が 802.11d に準拠しているかどうかを示します。
| pf11d | BYTE* | inout | 802.11d 準拠を示すブール値へのポインター。NIC が準拠している場合は TRUE、そうでない場合は FALSE が設定されます。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
NIC がアドホックネットワークの作成または使用をサポートしているかどうかを示します。
| pfAdHocCapable | BYTE* | inout | NIC のアドホックネットワーク機能を示すブール値へのポインター。NIC がアドホックネットワークの作成および使用をサポートしている場合は TRUE、そうでない場合は FALSE が設定されます。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
解説(Remarks)
pfAdHocCapable が FALSE に設定される理由は多数あり、次のようなものが含まれます。
- グループポリシーにより、このインターフェイスでのアドホックネットワークの使用が禁止されている
- コンピューターがインフラストラクチャネットワークにのみ接続するように構成されている、またはコンピューターの構成でワイヤレス接続が許可されていない
- NIC がアドホックネットワークをサポートしていない
無線 (ラジオ) がオンかどうかを示します。
| pfIsRadioOn | BYTE* | inout | 無線の状態を示すブール値へのポインター。無線がオンの場合は TRUE が設定されます。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
vtbl 8 HRESULT GetActiveNetwork(IDot11AdHocNetwork** ppNetwork)
インターフェイス上で現在アクティブなネットワークを取得します。
| ppNetwork | IDot11AdHocNetwork** | out | アクティブなネットワークを表す IDot11AdHocNetwork オブジェクトへのポインター。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
vtbl 9 HRESULT GetIEnumSecuritySettings(IEnumDot11AdHocSecuritySettings** ppEnum)
この NIC に関連付けられているセキュリティ設定のコレクションを取得します。
| ppEnum | IEnumDot11AdHocSecuritySettings** | out | セキュリティ設定のコレクションを格納する IEnumDot11AdHocSecuritySettings インターフェイスへのポインター。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| パラメーターとして渡されたポインターが無効です。 |
vtbl 10 HRESULT GetIEnumDot11AdHocNetworks(GUID* pFilterGuid, IEnumDot11AdHocNetworks** ppEnum)
この NIC に関連付けられているネットワークのコレクションを取得します。
| pFilterGuid | GUID* | in | ネットワークを作成したアプリケーションの GUID を指定する省略可能なパラメーター。アプリケーションはこの識別子を使用して、列挙されるネットワークを自身が作成したネットワークに限定できます。このフィルタリングが正しく機能するには、すべてのコンピューター上のすべてのアプリケーションインスタンスが同じ GUID を使用する必要があります。 |
| ppEnum | IEnumDot11AdHocNetworks** | out | 列挙されたネットワークを格納する IEnumDot11AdHocNetworks インターフェイスへのポインター。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
vtbl 11 HRESULT GetStatus(DOT11_ADHOC_NETWORK_CONNECTION_STATUS* pState)
この NIC に関連付けられているアクティブなネットワークの接続状態を取得します。
| pState | DOT11_ADHOC_NETWORK_CONNECTION_STATUS* | inout | 接続状態を示す DOT11_ADHOC_NETWORK_CONNECTION_STATUS 値へのポインター。 |
戻り値
戻り値には、次のものが含まれます (これらに限定されません)。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| メソッドが失敗しました。 | |
| パラメーターのいずれかが無効です。 | |
| この操作の実行に必要なメモリを割り当てられませんでした。 | |
| パラメーターとして渡されたポインターが無効です。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDot11AdHocInterface "{8F10CC2B-CF0D-42A0-ACBE-E2DE7007384D}" #usecom global IDot11AdHocInterface IID_IDot11AdHocInterface "{}" #comfunc global IDot11AdHocInterface_GetDeviceSignature 3 var #comfunc global IDot11AdHocInterface_GetFriendlyName 4 var #comfunc global IDot11AdHocInterface_IsDot11d 5 var #comfunc global IDot11AdHocInterface_IsAdHocCapable 6 var #comfunc global IDot11AdHocInterface_IsRadioOn 7 var #comfunc global IDot11AdHocInterface_GetActiveNetwork 8 sptr #comfunc global IDot11AdHocInterface_GetIEnumSecuritySettings 9 sptr #comfunc global IDot11AdHocInterface_GetIEnumDot11AdHocNetworks 10 var,sptr #comfunc global IDot11AdHocInterface_GetStatus 11 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDot11AdHocInterface "{8F10CC2B-CF0D-42A0-ACBE-E2DE7007384D}" #usecom global IDot11AdHocInterface IID_IDot11AdHocInterface "{}" #comfunc global IDot11AdHocInterface_GetDeviceSignature 3 sptr #comfunc global IDot11AdHocInterface_GetFriendlyName 4 sptr #comfunc global IDot11AdHocInterface_IsDot11d 5 sptr #comfunc global IDot11AdHocInterface_IsAdHocCapable 6 sptr #comfunc global IDot11AdHocInterface_IsRadioOn 7 sptr #comfunc global IDot11AdHocInterface_GetActiveNetwork 8 sptr #comfunc global IDot11AdHocInterface_GetIEnumSecuritySettings 9 sptr #comfunc global IDot11AdHocInterface_GetIEnumDot11AdHocNetworks 10 sptr,sptr #comfunc global IDot11AdHocInterface_GetStatus 11 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。