Win32 API 日本語リファレンス
ホームNetworkManagement.WiFi › WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK

構造体
サイズx64: 628 バイト / x86: 628 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
strProfileNameWCHAR512+0+0ネットワークに関連付けられたプロファイル名を格納します。ネットワークにプロファイルがない場合、このメンバーは空になります。複数のプロファイルがネットワークに関連付けられている場合は、可視ネットワークの一覧に同じ SSID を持つ複数のエントリが存在します。プロファイル名では大文字と小文字が区別されます。この文字列は NULL で終端されていなければなりません。
dot11SsidDOT11_SSID36+512+512可視のワイヤレスネットワークの SSID を格納する DOT11_SSID 構造体です。
dot11BssTypeDOT11_BSS_TYPE4+548+548ネットワークがインフラストラクチャかアドホックかを指定する DOT11_BSS_TYPE 値です。
uNumberOfBssidsDWORD4+552+552

ネットワーク内の BSSID の数を示します。

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: uNumberofBssids は、SSID をブロードキャストしているアクセスポイントの数にかかわらず、最大でも 1 です。

bNetworkConnectableBOOL4+556+556ネットワークに接続可能かどうかを示します。TRUE に設定されている場合、ネットワークは接続可能です。それ以外の場合、ネットワークには接続できません。
wlanNotConnectableReasonDWORD4+560+560ネットワークに接続できない理由を示す WLAN_REASON_CODE 値です。このメンバーは bNetworkConnectableFALSE の場合にのみ有効です。
uNumberOfPhyTypesDWORD4+564+564利用可能なネットワークでサポートされる PHY タイプの数です。uNumberOfPhyTypes の最大値は WLAN_MAX_PHY_TYPE_NUMBER であり、その値は 8 です。WLAN_MAX_PHY_TYPE_NUMBER を超える数の PHY タイプがサポートされている場合、bMorePhyTypesTRUE に設定しなければなりません。
dot11PhyTypesDOT11_PHY_TYPE32+568+568

利用可能なネットワークでサポートされる PHY タイプを表す DOT11_PHY_TYPE 値の配列を格納します。uNumberOfPhyTypesWLAN_MAX_PHY_TYPE_NUMBER より大きい場合、この配列には最初の WLAN_MAX_PHY_TYPE_NUMBER 個の PHY タイプのみが格納されます。

意味
dot11_phy_type_unknown
不明または未初期化の PHY タイプを指定します。
dot11_phy_type_any
任意の PHY タイプを指定します。
dot11_phy_type_fhss
周波数ホッピングスペクトラム拡散 (FHSS) PHY を指定します。Bluetooth デバイスは FHSS または FHSS を応用した方式を使用できます。
dot11_phy_type_dsss
直接スペクトラム拡散 (DSSS) PHY を指定します。
dot11_phy_type_irbaseband
赤外線 (IR) ベースバンド PHY を指定します。
dot11_phy_type_ofdm
直交周波数分割多重 (OFDM) PHY を指定します。802.11a デバイスは OFDM を使用できます。
dot11_phy_type_hrdsss
高速 DSSS (HRDSSS) PHY を指定します。
dot11_phy_type_erp
拡張レート PHY (ERP) を指定します。802.11g デバイスは ERP を使用できます。
dot11_phy_type_ht
802.11n PHY タイプを指定します。
dot11_phy_type_vht
802.11ac PHY タイプを指定します。これは IEEE 802.11ac で規定されている超高スループット (very high throughput) PHY タイプです。

この値は Windows 8.1、Windows Server 2012 R2 以降でサポートされます。

dot11_phy_type_IHV_start
独立系ハードウェアベンダー (IHV) が開発した PHY タイプを定義するために使用される範囲の開始を指定します。
dot11_phy_type_IHV_end
独立系ハードウェアベンダー (IHV) が開発した PHY タイプを定義するために使用される範囲の終了を指定します。
bMorePhyTypesBOOL4+600+600

WLAN_MAX_PHY_TYPE_NUMBER を超える数の PHY タイプがサポートされているかどうかを指定します。

このメンバーが TRUE に設定されている場合、アプリケーションは PHY タイプの完全な一覧を取得するために WlanGetNetworkBssList を呼び出さなければなりません。返される WLAN_BSS_LIST 構造体には、WLAN_BSS_ENTRY 構造体の配列が含まれます。WLAN_BSS_ENTRY 構造体の uPhyId メンバーには、そのエントリの PHY タイプが格納されます。

wlanSignalQualityDWORD4+604+604ネットワークの信号品質を表すパーセント値です。WLAN_SIGNAL_QUALITYULONG 型です。このメンバーには 0 から 100 の間の値が格納されます。値 0 は実際の RSSI 信号強度が -100 dbm であることを意味し、値 100 は実際の RSSI 信号強度が -50 dbm であることを意味します。1 から 99 までの wlanSignalQuality の値に対応する RSSI 信号強度は、線形補間によって算出できます。
bSecurityEnabledBOOL4+608+608ネットワークでセキュリティが有効かどうかを示します。TRUE の場合はセキュリティが有効であることを示し、それ以外の場合は有効ではありません。
dot11DefaultAuthAlgorithmDOT11_AUTH_ALGORITHM4+612+612このネットワークに初めて参加する際に使用される既定の認証アルゴリズムを示す DOT11_AUTH_ALGORITHM 値です。
dot11DefaultCipherAlgorithmDOT11_CIPHER_ALGORITHM4+616+616このネットワークに参加する際に使用される既定の暗号アルゴリズムを示す DOT11_CIPHER_ALGORITHM 値です。
dwFlagsDWORD4+620+620

ネットワークに関するさまざまなフラグを格納します。

意味
WLAN_AVAILABLE_NETWORK_CONNECTED
このネットワークは現在接続されています。
WLAN_AVAILABLE_NETWORK_HAS_PROFILE
このネットワークのプロファイルが存在します。
dwReservedDWORD4+624+624将来の使用のために予約済みです。NULL に設定しなければなりません。

公式ドキュメント

WLAN_AVAILABLE_NETWORK 構造体は、利用可能なワイヤレスネットワークに関する情報を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint32
struct 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