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

WLAN_ASSOCIATION_ATTRIBUTES

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 68 バイト / x86: 68 バイト

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

フィールド

フィールド型サイズx64x86説明
dot11SsidDOT11_SSID36+0+0関連付けの SSID を格納する DOT11_SSID 構造体です。
dot11BssTypeDOT11_BSS_TYPE4+36+36ネットワークがインフラストラクチャかアドホックかを指定する DOT11_BSS_TYPE 値です。
dot11BssidBYTE6+40+40関連付けの BSSID を格納する DOT11_MAC_ADDRESS です。
dot11PhyTypeDOT11_PHY_TYPE4+48+48関連付けの物理タイプを示す DOT11_PHY_TYPE 値です。
uDot11PhyIndexDWORD4+52+52PHY タイプの一覧を格納する構造体における DOT11_PHY_TYPE 値の位置です。
wlanSignalQualityDWORD4+56+56ネットワークの信号品質を表すパーセンテージ値です。 WLAN_SIGNAL_QUALITY は ULONG 型です。 このメンバーには 0 から 100 の範囲の値が格納されます。値 0 は、実際の RSSI 信号強度が -100 dbm であることを意味します。値 100 は、実際の RSSI 信号強度が -50 dbm であることを意味します。1 から 99 までの wlanSignalQuality の値については、線形補間によって実際の RSSI 信号強度を算出できます。
ulRxRateDWORD4+60+60関連付けの受信レートを格納します。
ulTxRateDWORD4+64+64関連付けの送信レートを格納します。

公式ドキュメント

WLAN_ASSOCIATION_ATTRIBUTES 構造体は、接続の関連付け属性を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ASSOCIATION_ATTRIBUTES  (x64 68 / x86 68 バイト)
typedef struct WLAN_ASSOCIATION_ATTRIBUTES {
    DOT11_SSID dot11Ssid;
    DOT11_BSS_TYPE dot11BssType;
    BYTE dot11Bssid[6];
    DOT11_PHY_TYPE dot11PhyType;
    DWORD uDot11PhyIndex;
    DWORD wlanSignalQuality;
    DWORD ulRxRate;
    DWORD ulTxRate;
} WLAN_ASSOCIATION_ATTRIBUTES;
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_ASSOCIATION_ATTRIBUTES
{
    public DOT11_SSID dot11Ssid;
    public int dot11BssType;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] dot11Bssid;
    public int dot11PhyType;
    public uint uDot11PhyIndex;
    public uint wlanSignalQuality;
    public uint ulRxRate;
    public uint ulTxRate;
}
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_ASSOCIATION_ATTRIBUTES
    Public dot11Ssid As DOT11_SSID
    Public dot11BssType As Integer
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public dot11Bssid() As Byte
    Public dot11PhyType As Integer
    Public uDot11PhyIndex As UInteger
    Public wlanSignalQuality As UInteger
    Public ulRxRate As UInteger
    Public ulTxRate 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_ASSOCIATION_ATTRIBUTES(ctypes.Structure):
    _fields_ = [
        ("dot11Ssid", DOT11_SSID),
        ("dot11BssType", ctypes.c_int),
        ("dot11Bssid", ctypes.c_ubyte * 6),
        ("dot11PhyType", ctypes.c_int),
        ("uDot11PhyIndex", wintypes.DWORD),
        ("wlanSignalQuality", wintypes.DWORD),
        ("ulRxRate", wintypes.DWORD),
        ("ulTxRate", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DOT11_SSID {
    pub uSSIDLength: u32,
    pub ucSSID: [u8; 32],
}

#[repr(C)]
pub struct WLAN_ASSOCIATION_ATTRIBUTES {
    pub dot11Ssid: DOT11_SSID,
    pub dot11BssType: i32,
    pub dot11Bssid: [u8; 6],
    pub dot11PhyType: i32,
    pub uDot11PhyIndex: u32,
    pub wlanSignalQuality: u32,
    pub ulRxRate: u32,
    pub ulTxRate: u32,
}
import "golang.org/x/sys/windows"

type DOT11_SSID struct {
	uSSIDLength uint32
	ucSSID [32]byte
}

type WLAN_ASSOCIATION_ATTRIBUTES struct {
	dot11Ssid DOT11_SSID
	dot11BssType int32
	dot11Bssid [6]byte
	dot11PhyType int32
	uDot11PhyIndex uint32
	wlanSignalQuality uint32
	ulRxRate uint32
	ulTxRate uint32
}
type
  DOT11_SSID = record
    uSSIDLength: DWORD;
    ucSSID: array[0..31] of Byte;
  end;

  WLAN_ASSOCIATION_ATTRIBUTES = record
    dot11Ssid: DOT11_SSID;
    dot11BssType: Integer;
    dot11Bssid: array[0..5] of Byte;
    dot11PhyType: Integer;
    uDot11PhyIndex: DWORD;
    wlanSignalQuality: DWORD;
    ulRxRate: DWORD;
    ulTxRate: DWORD;
  end;
const DOT11_SSID = extern struct {
    uSSIDLength: u32,
    ucSSID: [32]u8,
};

const WLAN_ASSOCIATION_ATTRIBUTES = extern struct {
    dot11Ssid: DOT11_SSID,
    dot11BssType: i32,
    dot11Bssid: [6]u8,
    dot11PhyType: i32,
    uDot11PhyIndex: u32,
    wlanSignalQuality: u32,
    ulRxRate: u32,
    ulTxRate: u32,
};
type
  DOT11_SSID {.bycopy.} = object
    uSSIDLength: uint32
    ucSSID: array[32, uint8]

  WLAN_ASSOCIATION_ATTRIBUTES {.bycopy.} = object
    dot11Ssid: DOT11_SSID
    dot11BssType: int32
    dot11Bssid: array[6, uint8]
    dot11PhyType: int32
    uDot11PhyIndex: uint32
    wlanSignalQuality: uint32
    ulRxRate: uint32
    ulTxRate: uint32
struct DOT11_SSID
{
    uint uSSIDLength;
    ubyte[32] ucSSID;
}

struct WLAN_ASSOCIATION_ATTRIBUTES
{
    DOT11_SSID dot11Ssid;
    int dot11BssType;
    ubyte[6] dot11Bssid;
    int dot11PhyType;
    uint uDot11PhyIndex;
    uint wlanSignalQuality;
    uint ulRxRate;
    uint ulTxRate;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WLAN_ASSOCIATION_ATTRIBUTES サイズ: 68 バイト(x64)
dim st, 17    ; 4byte整数×17(構造体サイズ 68 / 4 切り上げ)
; dot11Ssid : DOT11_SSID (+0, 36byte)  varptr(st)+0 を基点に操作(36byte:入れ子/配列)
; dot11BssType : DOT11_BSS_TYPE (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dot11Bssid : BYTE (+40, 6byte)  varptr(st)+40 を基点に操作(6byte:入れ子/配列)
; dot11PhyType : DOT11_PHY_TYPE (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; uDot11PhyIndex : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; wlanSignalQuality : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ulRxRate : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ulTxRate : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (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_ASSOCIATION_ATTRIBUTES
    #field DOT11_SSID dot11Ssid
    #field int dot11BssType
    #field byte dot11Bssid 6
    #field int dot11PhyType
    #field int uDot11PhyIndex
    #field int wlanSignalQuality
    #field int ulRxRate
    #field int ulTxRate
#endstruct

stdim st, WLAN_ASSOCIATION_ATTRIBUTES        ; NSTRUCT 変数を確保
st->dot11BssType = 100
mes "dot11BssType=" + st->dot11BssType