WLAN_AVAILABLE_NETWORK
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| strProfileName | WCHAR | 512 | +0 | +0 | ネットワークに関連付けられたプロファイル名を格納します。ネットワークにプロファイルがない場合、このメンバーは空になります。複数のプロファイルがネットワークに関連付けられている場合は、可視ネットワークの一覧に同じ SSID を持つ複数のエントリが存在します。プロファイル名では大文字と小文字が区別されます。この文字列は NULL で終端されていなければなりません。 | ||||||
| dot11Ssid | DOT11_SSID | 36 | +512 | +512 | 可視のワイヤレスネットワークの SSID を格納する DOT11_SSID 構造体です。 | ||||||
| dot11BssType | DOT11_BSS_TYPE | 4 | +548 | +548 | ネットワークがインフラストラクチャかアドホックかを指定する DOT11_BSS_TYPE 値です。 | ||||||
| uNumberOfBssids | DWORD | 4 | +552 | +552 | ネットワーク内の BSSID の数を示します。 Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: uNumberofBssids は、SSID をブロードキャストしているアクセスポイントの数にかかわらず、最大でも 1 です。 | ||||||
| bNetworkConnectable | BOOL | 4 | +556 | +556 | ネットワークに接続可能かどうかを示します。TRUE に設定されている場合、ネットワークは接続可能です。それ以外の場合、ネットワークには接続できません。 | ||||||
| wlanNotConnectableReason | DWORD | 4 | +560 | +560 | ネットワークに接続できない理由を示す WLAN_REASON_CODE 値です。このメンバーは bNetworkConnectable が FALSE の場合にのみ有効です。 | ||||||
| uNumberOfPhyTypes | DWORD | 4 | +564 | +564 | 利用可能なネットワークでサポートされる PHY タイプの数です。uNumberOfPhyTypes の最大値は WLAN_MAX_PHY_TYPE_NUMBER であり、その値は 8 です。WLAN_MAX_PHY_TYPE_NUMBER を超える数の PHY タイプがサポートされている場合、bMorePhyTypes を TRUE に設定しなければなりません。 | ||||||
| dot11PhyTypes | DOT11_PHY_TYPE | 32 | +568 | +568 | 利用可能なネットワークでサポートされる PHY タイプを表す DOT11_PHY_TYPE 値の配列を格納します。uNumberOfPhyTypes が WLAN_MAX_PHY_TYPE_NUMBER より大きい場合、この配列には最初の WLAN_MAX_PHY_TYPE_NUMBER 個の PHY タイプのみが格納されます。 | ||||||
| bMorePhyTypes | BOOL | 4 | +600 | +600 | WLAN_MAX_PHY_TYPE_NUMBER を超える数の PHY タイプがサポートされているかどうかを指定します。 このメンバーが TRUE に設定されている場合、アプリケーションは PHY タイプの完全な一覧を取得するために WlanGetNetworkBssList を呼び出さなければなりません。返される WLAN_BSS_LIST 構造体には、WLAN_BSS_ENTRY 構造体の配列が含まれます。WLAN_BSS_ENTRY 構造体の uPhyId メンバーには、そのエントリの PHY タイプが格納されます。 | ||||||
| wlanSignalQuality | DWORD | 4 | +604 | +604 | ネットワークの信号品質を表すパーセント値です。WLAN_SIGNAL_QUALITY は ULONG 型です。このメンバーには 0 から 100 の間の値が格納されます。値 0 は実際の RSSI 信号強度が -100 dbm であることを意味し、値 100 は実際の RSSI 信号強度が -50 dbm であることを意味します。1 から 99 までの wlanSignalQuality の値に対応する RSSI 信号強度は、線形補間によって算出できます。 | ||||||
| bSecurityEnabled | BOOL | 4 | +608 | +608 | ネットワークでセキュリティが有効かどうかを示します。TRUE の場合はセキュリティが有効であることを示し、それ以外の場合は有効ではありません。 | ||||||
| dot11DefaultAuthAlgorithm | DOT11_AUTH_ALGORITHM | 4 | +612 | +612 | このネットワークに初めて参加する際に使用される既定の認証アルゴリズムを示す DOT11_AUTH_ALGORITHM 値です。 | ||||||
| dot11DefaultCipherAlgorithm | DOT11_CIPHER_ALGORITHM | 4 | +616 | +616 | このネットワークに参加する際に使用される既定の暗号アルゴリズムを示す DOT11_CIPHER_ALGORITHM 値です。 | ||||||
| dwFlags | DWORD | 4 | +620 | +620 | ネットワークに関するさまざまなフラグを格納します。
| ||||||
| dwReserved | DWORD | 4 | +624 | +624 | 将来の使用のために予約済みです。NULL に設定しなければなりません。 |
公式ドキュメント
WLAN_AVAILABLE_NETWORK 構造体は、利用可能なワイヤレスネットワークに関する情報を格納します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DOT11_SSID (x64 36 / x86 36 バイト)
typedef struct DOT11_SSID {
DWORD uSSIDLength;
BYTE ucSSID[32];
} DOT11_SSID;
// WLAN_AVAILABLE_NETWORK (x64 628 / x86 628 バイト)
typedef struct WLAN_AVAILABLE_NETWORK {
WCHAR strProfileName[256];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
DWORD uNumberOfBssids;
BOOL bNetworkConnectable;
DWORD wlanNotConnectableReason;
DWORD uNumberOfPhyTypes;
DOT11_PHY_TYPE dot11PhyTypes[8];
BOOL bMorePhyTypes;
DWORD wlanSignalQuality;
BOOL bSecurityEnabled;
DOT11_AUTH_ALGORITHM dot11DefaultAuthAlgorithm;
DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
DWORD dwFlags;
DWORD dwReserved;
} WLAN_AVAILABLE_NETWORK;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_SSID
{
public uint uSSIDLength;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 32)] public byte[] ucSSID;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WLAN_AVAILABLE_NETWORK
{
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string strProfileName;
public DOT11_SSID dot11Ssid;
public int dot11BssType;
public uint uNumberOfBssids;
[MarshalAs(UnmanagedType.Bool)] public bool bNetworkConnectable;
public uint wlanNotConnectableReason;
public uint uNumberOfPhyTypes;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public int[] dot11PhyTypes;
[MarshalAs(UnmanagedType.Bool)] public bool bMorePhyTypes;
public uint wlanSignalQuality;
[MarshalAs(UnmanagedType.Bool)] public bool bSecurityEnabled;
public int dot11DefaultAuthAlgorithm;
public int dot11DefaultCipherAlgorithm;
public uint dwFlags;
public uint dwReserved;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_SSID
Public uSSIDLength As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=32)> Public ucSSID() As Byte
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WLAN_AVAILABLE_NETWORK
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public strProfileName As String
Public dot11Ssid As DOT11_SSID
Public dot11BssType As Integer
Public uNumberOfBssids As UInteger
<MarshalAs(UnmanagedType.Bool)> Public bNetworkConnectable As Boolean
Public wlanNotConnectableReason As UInteger
Public uNumberOfPhyTypes As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public dot11PhyTypes() As Integer
<MarshalAs(UnmanagedType.Bool)> Public bMorePhyTypes As Boolean
Public wlanSignalQuality As UInteger
<MarshalAs(UnmanagedType.Bool)> Public bSecurityEnabled As Boolean
Public dot11DefaultAuthAlgorithm As Integer
Public dot11DefaultCipherAlgorithm As Integer
Public dwFlags As UInteger
Public dwReserved As UInteger
End Structureimport ctypes
from ctypes import wintypes
class DOT11_SSID(ctypes.Structure):
_fields_ = [
("uSSIDLength", wintypes.DWORD),
("ucSSID", ctypes.c_ubyte * 32),
]
class WLAN_AVAILABLE_NETWORK(ctypes.Structure):
_fields_ = [
("strProfileName", ctypes.c_wchar * 256),
("dot11Ssid", DOT11_SSID),
("dot11BssType", ctypes.c_int),
("uNumberOfBssids", wintypes.DWORD),
("bNetworkConnectable", wintypes.BOOL),
("wlanNotConnectableReason", wintypes.DWORD),
("uNumberOfPhyTypes", wintypes.DWORD),
("dot11PhyTypes", ctypes.c_int * 8),
("bMorePhyTypes", wintypes.BOOL),
("wlanSignalQuality", wintypes.DWORD),
("bSecurityEnabled", wintypes.BOOL),
("dot11DefaultAuthAlgorithm", ctypes.c_int),
("dot11DefaultCipherAlgorithm", ctypes.c_int),
("dwFlags", wintypes.DWORD),
("dwReserved", wintypes.DWORD),
]#[repr(C)]
pub struct DOT11_SSID {
pub uSSIDLength: u32,
pub ucSSID: [u8; 32],
}
#[repr(C)]
pub struct WLAN_AVAILABLE_NETWORK {
pub strProfileName: [u16; 256],
pub dot11Ssid: DOT11_SSID,
pub dot11BssType: i32,
pub uNumberOfBssids: u32,
pub bNetworkConnectable: i32,
pub wlanNotConnectableReason: u32,
pub uNumberOfPhyTypes: u32,
pub dot11PhyTypes: [i32; 8],
pub bMorePhyTypes: i32,
pub wlanSignalQuality: u32,
pub bSecurityEnabled: i32,
pub dot11DefaultAuthAlgorithm: i32,
pub dot11DefaultCipherAlgorithm: i32,
pub dwFlags: u32,
pub dwReserved: u32,
}import "golang.org/x/sys/windows"
type DOT11_SSID struct {
uSSIDLength uint32
ucSSID [32]byte
}
type WLAN_AVAILABLE_NETWORK struct {
strProfileName [256]uint16
dot11Ssid DOT11_SSID
dot11BssType int32
uNumberOfBssids uint32
bNetworkConnectable int32
wlanNotConnectableReason uint32
uNumberOfPhyTypes uint32
dot11PhyTypes [8]int32
bMorePhyTypes int32
wlanSignalQuality uint32
bSecurityEnabled int32
dot11DefaultAuthAlgorithm int32
dot11DefaultCipherAlgorithm int32
dwFlags uint32
dwReserved uint32
}type
DOT11_SSID = record
uSSIDLength: DWORD;
ucSSID: array[0..31] of Byte;
end;
WLAN_AVAILABLE_NETWORK = record
strProfileName: array[0..255] of WideChar;
dot11Ssid: DOT11_SSID;
dot11BssType: Integer;
uNumberOfBssids: DWORD;
bNetworkConnectable: BOOL;
wlanNotConnectableReason: DWORD;
uNumberOfPhyTypes: DWORD;
dot11PhyTypes: array[0..7] of Integer;
bMorePhyTypes: BOOL;
wlanSignalQuality: DWORD;
bSecurityEnabled: BOOL;
dot11DefaultAuthAlgorithm: Integer;
dot11DefaultCipherAlgorithm: Integer;
dwFlags: DWORD;
dwReserved: DWORD;
end;const DOT11_SSID = extern struct {
uSSIDLength: u32,
ucSSID: [32]u8,
};
const WLAN_AVAILABLE_NETWORK = extern struct {
strProfileName: [256]u16,
dot11Ssid: DOT11_SSID,
dot11BssType: i32,
uNumberOfBssids: u32,
bNetworkConnectable: i32,
wlanNotConnectableReason: u32,
uNumberOfPhyTypes: u32,
dot11PhyTypes: [8]i32,
bMorePhyTypes: i32,
wlanSignalQuality: u32,
bSecurityEnabled: i32,
dot11DefaultAuthAlgorithm: i32,
dot11DefaultCipherAlgorithm: i32,
dwFlags: u32,
dwReserved: u32,
};type
DOT11_SSID {.bycopy.} = object
uSSIDLength: uint32
ucSSID: array[32, uint8]
WLAN_AVAILABLE_NETWORK {.bycopy.} = object
strProfileName: array[256, uint16]
dot11Ssid: DOT11_SSID
dot11BssType: int32
uNumberOfBssids: uint32
bNetworkConnectable: int32
wlanNotConnectableReason: uint32
uNumberOfPhyTypes: uint32
dot11PhyTypes: array[8, int32]
bMorePhyTypes: int32
wlanSignalQuality: uint32
bSecurityEnabled: int32
dot11DefaultAuthAlgorithm: int32
dot11DefaultCipherAlgorithm: int32
dwFlags: uint32
dwReserved: uint32struct DOT11_SSID
{
uint uSSIDLength;
ubyte[32] ucSSID;
}
struct WLAN_AVAILABLE_NETWORK
{
wchar[256] strProfileName;
DOT11_SSID dot11Ssid;
int dot11BssType;
uint uNumberOfBssids;
int bNetworkConnectable;
uint wlanNotConnectableReason;
uint uNumberOfPhyTypes;
int[8] dot11PhyTypes;
int bMorePhyTypes;
uint wlanSignalQuality;
int bSecurityEnabled;
int dot11DefaultAuthAlgorithm;
int dot11DefaultCipherAlgorithm;
uint dwFlags;
uint dwReserved;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WLAN_AVAILABLE_NETWORK サイズ: 628 バイト(x64)
dim st, 157 ; 4byte整数×157(構造体サイズ 628 / 4 切り上げ)
; strProfileName : WCHAR (+0, 512byte) varptr(st)+0 を基点に操作(512byte:入れ子/配列)
; dot11Ssid : DOT11_SSID (+512, 36byte) varptr(st)+512 を基点に操作(36byte:入れ子/配列)
; dot11BssType : DOT11_BSS_TYPE (+548, 4byte) st.137 = 値 / 値 = st.137 (lpoke/lpeek も可)
; uNumberOfBssids : DWORD (+552, 4byte) st.138 = 値 / 値 = st.138 (lpoke/lpeek も可)
; bNetworkConnectable : BOOL (+556, 4byte) st.139 = 値 / 値 = st.139 (lpoke/lpeek も可)
; wlanNotConnectableReason : DWORD (+560, 4byte) st.140 = 値 / 値 = st.140 (lpoke/lpeek も可)
; uNumberOfPhyTypes : DWORD (+564, 4byte) st.141 = 値 / 値 = st.141 (lpoke/lpeek も可)
; dot11PhyTypes : DOT11_PHY_TYPE (+568, 32byte) varptr(st)+568 を基点に操作(32byte:入れ子/配列)
; bMorePhyTypes : BOOL (+600, 4byte) st.150 = 値 / 値 = st.150 (lpoke/lpeek も可)
; wlanSignalQuality : DWORD (+604, 4byte) st.151 = 値 / 値 = st.151 (lpoke/lpeek も可)
; bSecurityEnabled : BOOL (+608, 4byte) st.152 = 値 / 値 = st.152 (lpoke/lpeek も可)
; dot11DefaultAuthAlgorithm : DOT11_AUTH_ALGORITHM (+612, 4byte) st.153 = 値 / 値 = st.153 (lpoke/lpeek も可)
; dot11DefaultCipherAlgorithm : DOT11_CIPHER_ALGORITHM (+616, 4byte) st.154 = 値 / 値 = st.154 (lpoke/lpeek も可)
; dwFlags : DWORD (+620, 4byte) st.155 = 値 / 値 = st.155 (lpoke/lpeek も可)
; dwReserved : DWORD (+624, 4byte) st.156 = 値 / 値 = st.156 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DOT11_SSID
#field int uSSIDLength
#field byte ucSSID 32
#endstruct
#defstruct global WLAN_AVAILABLE_NETWORK
#field wchar strProfileName 256
#field DOT11_SSID dot11Ssid
#field int dot11BssType
#field int uNumberOfBssids
#field bool bNetworkConnectable
#field int wlanNotConnectableReason
#field int uNumberOfPhyTypes
#field int dot11PhyTypes 8
#field bool bMorePhyTypes
#field int wlanSignalQuality
#field bool bSecurityEnabled
#field int dot11DefaultAuthAlgorithm
#field int dot11DefaultCipherAlgorithm
#field int dwFlags
#field int dwReserved
#endstruct
stdim st, WLAN_AVAILABLE_NETWORK ; NSTRUCT 変数を確保
st->dot11BssType = 100
mes "dot11BssType=" + st->dot11BssType