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

DOT11_AP_JOIN_REQUEST

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

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

フィールド

フィールド型サイズx64x86説明
uJoinFailureTimeoutDWORD4+0+0AP 参加処理のタイムアウト時間をTU単位で表す。
OperationalRateSetDOT11_RATE_SET132+4+4使用する運用レートセットを指定する。
uChCenterFrequencyDWORD4+136+136接続先チャネルの中心周波数を表す。
dot11BSSDescriptionDOT11_BSS_DESCRIPTION48+144+144参加対象 BSS の記述情報。

各言語での定義

#include <windows.h>

// DOT11_RATE_SET  (x64 132 / x86 132 バイト)
typedef struct DOT11_RATE_SET {
    DWORD uRateSetLength;
    BYTE ucRateSet[126];
} DOT11_RATE_SET;

// DOT11_BSS_DESCRIPTION  (x64 48 / x86 48 バイト)
typedef struct DOT11_BSS_DESCRIPTION {
    DWORD uReserved;
    BYTE dot11BSSID[6];
    DOT11_BSS_TYPE dot11BSSType;
    WORD usBeaconPeriod;
    ULONGLONG ullTimestamp;
    WORD usCapabilityInformation;
    DWORD uBufferLength;
    BYTE ucBuffer[1];
} DOT11_BSS_DESCRIPTION;

// DOT11_AP_JOIN_REQUEST  (x64 192 / x86 192 バイト)
typedef struct DOT11_AP_JOIN_REQUEST {
    DWORD uJoinFailureTimeout;
    DOT11_RATE_SET OperationalRateSet;
    DWORD uChCenterFrequency;
    DOT11_BSS_DESCRIPTION dot11BSSDescription;
} DOT11_AP_JOIN_REQUEST;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_RATE_SET
{
    public uint uRateSetLength;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 126)] public byte[] ucRateSet;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_BSS_DESCRIPTION
{
    public uint uReserved;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] dot11BSSID;
    public int dot11BSSType;
    public ushort usBeaconPeriod;
    public ulong ullTimestamp;
    public ushort usCapabilityInformation;
    public uint uBufferLength;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public byte[] ucBuffer;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DOT11_AP_JOIN_REQUEST
{
    public uint uJoinFailureTimeout;
    public DOT11_RATE_SET OperationalRateSet;
    public uint uChCenterFrequency;
    public DOT11_BSS_DESCRIPTION dot11BSSDescription;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_RATE_SET
    Public uRateSetLength As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=126)> Public ucRateSet() As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_BSS_DESCRIPTION
    Public uReserved As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public dot11BSSID() As Byte
    Public dot11BSSType As Integer
    Public usBeaconPeriod As UShort
    Public ullTimestamp As ULong
    Public usCapabilityInformation As UShort
    Public uBufferLength As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public ucBuffer() As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DOT11_AP_JOIN_REQUEST
    Public uJoinFailureTimeout As UInteger
    Public OperationalRateSet As DOT11_RATE_SET
    Public uChCenterFrequency As UInteger
    Public dot11BSSDescription As DOT11_BSS_DESCRIPTION
End Structure
import ctypes
from ctypes import wintypes

class DOT11_RATE_SET(ctypes.Structure):
    _fields_ = [
        ("uRateSetLength", wintypes.DWORD),
        ("ucRateSet", ctypes.c_ubyte * 126),
    ]

class DOT11_BSS_DESCRIPTION(ctypes.Structure):
    _fields_ = [
        ("uReserved", wintypes.DWORD),
        ("dot11BSSID", ctypes.c_ubyte * 6),
        ("dot11BSSType", ctypes.c_int),
        ("usBeaconPeriod", ctypes.c_ushort),
        ("ullTimestamp", ctypes.c_ulonglong),
        ("usCapabilityInformation", ctypes.c_ushort),
        ("uBufferLength", wintypes.DWORD),
        ("ucBuffer", ctypes.c_ubyte * 1),
    ]

class DOT11_AP_JOIN_REQUEST(ctypes.Structure):
    _fields_ = [
        ("uJoinFailureTimeout", wintypes.DWORD),
        ("OperationalRateSet", DOT11_RATE_SET),
        ("uChCenterFrequency", wintypes.DWORD),
        ("dot11BSSDescription", DOT11_BSS_DESCRIPTION),
    ]
#[repr(C)]
pub struct DOT11_RATE_SET {
    pub uRateSetLength: u32,
    pub ucRateSet: [u8; 126],
}

#[repr(C)]
pub struct DOT11_BSS_DESCRIPTION {
    pub uReserved: u32,
    pub dot11BSSID: [u8; 6],
    pub dot11BSSType: i32,
    pub usBeaconPeriod: u16,
    pub ullTimestamp: u64,
    pub usCapabilityInformation: u16,
    pub uBufferLength: u32,
    pub ucBuffer: [u8; 1],
}

#[repr(C)]
pub struct DOT11_AP_JOIN_REQUEST {
    pub uJoinFailureTimeout: u32,
    pub OperationalRateSet: DOT11_RATE_SET,
    pub uChCenterFrequency: u32,
    pub dot11BSSDescription: DOT11_BSS_DESCRIPTION,
}
import "golang.org/x/sys/windows"

type DOT11_RATE_SET struct {
	uRateSetLength uint32
	ucRateSet [126]byte
}

type DOT11_BSS_DESCRIPTION struct {
	uReserved uint32
	dot11BSSID [6]byte
	dot11BSSType int32
	usBeaconPeriod uint16
	ullTimestamp uint64
	usCapabilityInformation uint16
	uBufferLength uint32
	ucBuffer [1]byte
}

type DOT11_AP_JOIN_REQUEST struct {
	uJoinFailureTimeout uint32
	OperationalRateSet DOT11_RATE_SET
	uChCenterFrequency uint32
	dot11BSSDescription DOT11_BSS_DESCRIPTION
}
type
  DOT11_RATE_SET = record
    uRateSetLength: DWORD;
    ucRateSet: array[0..125] of Byte;
  end;

  DOT11_BSS_DESCRIPTION = record
    uReserved: DWORD;
    dot11BSSID: array[0..5] of Byte;
    dot11BSSType: Integer;
    usBeaconPeriod: Word;
    ullTimestamp: UInt64;
    usCapabilityInformation: Word;
    uBufferLength: DWORD;
    ucBuffer: array[0..0] of Byte;
  end;

  DOT11_AP_JOIN_REQUEST = record
    uJoinFailureTimeout: DWORD;
    OperationalRateSet: DOT11_RATE_SET;
    uChCenterFrequency: DWORD;
    dot11BSSDescription: DOT11_BSS_DESCRIPTION;
  end;
const DOT11_RATE_SET = extern struct {
    uRateSetLength: u32,
    ucRateSet: [126]u8,
};

const DOT11_BSS_DESCRIPTION = extern struct {
    uReserved: u32,
    dot11BSSID: [6]u8,
    dot11BSSType: i32,
    usBeaconPeriod: u16,
    ullTimestamp: u64,
    usCapabilityInformation: u16,
    uBufferLength: u32,
    ucBuffer: [1]u8,
};

const DOT11_AP_JOIN_REQUEST = extern struct {
    uJoinFailureTimeout: u32,
    OperationalRateSet: DOT11_RATE_SET,
    uChCenterFrequency: u32,
    dot11BSSDescription: DOT11_BSS_DESCRIPTION,
};
type
  DOT11_RATE_SET {.bycopy.} = object
    uRateSetLength: uint32
    ucRateSet: array[126, uint8]

  DOT11_BSS_DESCRIPTION {.bycopy.} = object
    uReserved: uint32
    dot11BSSID: array[6, uint8]
    dot11BSSType: int32
    usBeaconPeriod: uint16
    ullTimestamp: uint64
    usCapabilityInformation: uint16
    uBufferLength: uint32
    ucBuffer: array[1, uint8]

  DOT11_AP_JOIN_REQUEST {.bycopy.} = object
    uJoinFailureTimeout: uint32
    OperationalRateSet: DOT11_RATE_SET
    uChCenterFrequency: uint32
    dot11BSSDescription: DOT11_BSS_DESCRIPTION
struct DOT11_RATE_SET
{
    uint uRateSetLength;
    ubyte[126] ucRateSet;
}

struct DOT11_BSS_DESCRIPTION
{
    uint uReserved;
    ubyte[6] dot11BSSID;
    int dot11BSSType;
    ushort usBeaconPeriod;
    ulong ullTimestamp;
    ushort usCapabilityInformation;
    uint uBufferLength;
    ubyte[1] ucBuffer;
}

struct DOT11_AP_JOIN_REQUEST
{
    uint uJoinFailureTimeout;
    DOT11_RATE_SET OperationalRateSet;
    uint uChCenterFrequency;
    DOT11_BSS_DESCRIPTION dot11BSSDescription;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DOT11_AP_JOIN_REQUEST サイズ: 192 バイト(x64)
dim st, 48    ; 4byte整数×48(構造体サイズ 192 / 4 切り上げ)
; uJoinFailureTimeout : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; OperationalRateSet : DOT11_RATE_SET (+4, 132byte)  varptr(st)+4 を基点に操作(132byte:入れ子/配列)
; uChCenterFrequency : DWORD (+136, 4byte)  st.34 = 値  /  値 = st.34   (lpoke/lpeek も可)
; dot11BSSDescription : DOT11_BSS_DESCRIPTION (+144, 48byte)  varptr(st)+144 を基点に操作(48byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DOT11_RATE_SET
    #field int uRateSetLength
    #field byte ucRateSet 126
#endstruct

#defstruct global DOT11_BSS_DESCRIPTION
    #field int uReserved
    #field byte dot11BSSID 6
    #field int dot11BSSType
    #field short usBeaconPeriod
    #field int64 ullTimestamp
    #field short usCapabilityInformation
    #field int uBufferLength
    #field byte ucBuffer 1
#endstruct

#defstruct global DOT11_AP_JOIN_REQUEST
    #field int uJoinFailureTimeout
    #field DOT11_RATE_SET OperationalRateSet
    #field int uChCenterFrequency
    #field DOT11_BSS_DESCRIPTION dot11BSSDescription
#endstruct

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