# win32wifi - Windows Native Wifi Api Python library.
# Copyright (C) 2016 - Shaked Gitelman
#
# Forked from: PyWiWi - <https://github.com/6e726d/PyWiWi>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
# Author: Andres Blanco (6e726d) <6e726d@gmail.com>
# Author: Shaked Gitelman (almondg) <shaked.dev@gmail.com>
#
from ctypes import *
from enum import Enum
from comtypes import GUID
from ctypes.wintypes import BOOL
from ctypes.wintypes import DWORD
from ctypes.wintypes import HANDLE
from ctypes.wintypes import LPWSTR
from ctypes.wintypes import LPCWSTR
ERROR_SUCCESS = 0
CLIENT_VERSION_WINDOWS_XP_SP3 = 1
CLIENT_VERSION_WINDOWS_VISTA_OR_LATER = 2
# Windot11.h defines
DOT11_SSID_MAX_LENGTH = 32
DOT11_BSSID_LIST_REVISION_1 = 1
# Ntddndis.h defines
NDIS_OBJECT_TYPE_DEFAULT = 0x80
wlanapi = windll.LoadLibrary('wlanapi.dll')
# The WLAN_INTERFACE_STATE enumerated type indicates the state of an interface.
WLAN_INTERFACE_STATE = c_uint
WLAN_INTERFACE_STATE_DICT = {0: "wlan_interface_state_not_ready",
1: "wlan_interface_state_connected",
2: "wlan_interface_state_ad_hoc_network_formed",
3: "wlan_interface_state_disconnecting",
4: "wlan_interface_state_disconnected",
5: "wlan_interface_state_associating",
6: "wlan_interface_state_discovering",
7: "wlan_interface_state_authenticating"}
# The DOT11_MAC_ADDRESS types are used to define an IEEE media access control
# (MAC) address.
DOT11_MAC_ADDRESS = c_ubyte * 6
# The DOT11_BSS_TYPE enumerated type defines a basic service set (BSS) network
# type.
DOT11_BSS_TYPE = c_uint
DOT11_BSS_TYPE_DICT_KV = {
1: "dot11_BSS_type_infrastructure",
2: "dot11_BSS_type_independent",
3: "dot11_BSS_type_any"
}
try:
DOT11_BSS_TYPE_DICT_VK = { v: k for k, v in
DOT11_BSS_TYPE_DICT_KV.items() }
except AttributeError:
DOT11_BSS_TYPE_DICT_VK = { v: k for k, v in
DOT11_BSS_TYPE_DICT_KV.items() }
# The DOT11_PHY_TYPE enumeration defines an 802.11 PHY and media type.
DOT11_PHY_TYPE = c_uint
DOT11_PHY_TYPE_DICT = {0: "dot11_phy_type_unknown",
1: "dot11_phy_type_fhss",
2: "dot11_phy_type_dsss",
3: "dot11_phy_type_irbaseband",
4: "dot11_phy_type_ofdm",
5: "dot11_phy_type_hrdsss",
6: "dot11_phy_type_erp",
7: "dot11_phy_type_ht",
8: "dot11_phy_type_vht",
0x80000000: "dot11_phy_type_IHV_start",
0xffffffff: "dot11_phy_type_IHV_end"}
# The DOT11_AUTH_ALGORITHM enumerated type defines a wireless LAN
# authentication algorithm.
DOT11_AUTH_ALGORITHM_TYPE = c_uint
DOT11_AUTH_ALGORITHM_DICT = {1: "DOT11_AUTH_ALGO_80211_OPEN",
2: "DOT11_AUTH_ALGO_80211_SHARED_KEY",
3: "DOT11_AUTH_ALGO_WPA",
4: "DOT11_AUTH_ALGO_WPA_PSK",
5: "DOT11_AUTH_ALGO_WPA_NONE",
6: "DOT11_AUTH_ALGO_RSNA",
7: "DOT11_AUTH_ALGO_RSNA_PSK",
0x80000000: "DOT11_AUTH_ALGO_IHV_START",
0xffffffff: "DOT11_AUTH_ALGO_IHV_END"}
# The DOT11_CIPHER_ALGORITHM enumerated type defines a cipher algorithm for
# data encryption and decryption.
DOT11_CIPHER_ALGORITHM_TYPE = c_uint
DOT11_CIPHER_ALGORITHM_DICT = {0x00: "DOT11_CIPHER_ALGO_NONE",
0x01: "DOT11_CIPHER_ALGO_WEP40",
0x02: "DOT11_CIPHER_ALGO_TKIP",
0x04: "DOT11_CIPHER_ALGO_CCMP",
0x05: "DOT11_CIPHER_ALGO_WEP104",
0x100: "DOT11_CIPHER_ALGO_WPA_USE_GROUP",
0x100: "DOT11_CIPHER_ALGO_RSN_USE_GROUP",
0x101: "DOT11_CIPHER_ALGO_WEP",
0x80000000: "DOT11_CIPHER_ALGO_IHV_START",
0xffffffff: "DOT11_CIPHER_ALGO_IHV_END"}
DOT11_RADIO_STATE = c_uint
#TODO: values not verified
DOT11_RADIO_STATE_DICT = {0: "dot11_radio_state_unknown",
1: "dot11_radio_state_on",
2: "dot11_radio_state_off"}
WLAN_REASON_CODE = DWORD
WLAN_SIGNAL_QUALITY = c_ulong
WLAN_MAX_PHY_TYPE_NUMBER = 8
DOT11_RATE_SET_MAX_LENGTH = 126
# WLAN_AVAILABLE_NETWORK Flags
WLAN_AVAILABLE_NETWORK_CONNECTED = 0x00000001
WLAN_AVAILABLE_NETWORK_HAS_PROFILE = 0x00000002
WLAN_AVAILABLE_NETWORK_CONSOLE_USER_PROFILE = 0x00000004
WLAN_AVAILABLE_NETWORK_INCLUDE_ALL_ADHOC_PROFILES = 0x00000001
WLAN_AVAILABLE_NETWORK_INCLUDE_ALL_MANUAL_HIDDEN_PROFILES = 0x00000002
# WLAN Profile Flags
WLAN_PROFILE_GROUP_POLICY = 0x00000001
WLAN_PROFILE_USER = 0x00000002
WLAN_PROFILE_GET_PLAINTEXT_KEY = 0x00000004
# WLAN Notification Registration Flags
WLAN_NOTIFICATION_SOURCE_NONE = 0x0000
WLAN_NOTIFICATION_SOURCE_ONEX = 0x0004
WLAN_NOTIFICATION_SOURCE_ACM = 0x0008
WLAN_NOTIFICATION_SOURCE_MSM = 0x0010
WLAN_NOTIFICATION_SOURCE_SECURITY = 0x0020
WLAN_NOTIFICATION_SOURCE_IHV = 0x0040
WLAN_NOTIFICATION_SOURCE_HNWK = 0x0080
WLAN_NOTIFICATION_SOURCE_ALL = 0xffff
WLAN_NOTIFICATION_SOURCE_DICT = {
WLAN_NOTIFICATION_SOURCE_NONE: "WLAN_NOTIFICATION_SOURCE_NONE",
WLAN_NOTIFICATION_SOURCE_ONEX: "WLAN_NOTIFICATION_SOURCE_ONEX",
WLAN_NOTIFICATION_SOURCE_ACM: "WLAN_NOTIFICATION_SOURCE_ACM",
WLAN_NOTIFICATION_SOURCE_MSM: "WLAN_NOTIFICATION_SOURCE_MSM",
WLAN_NOTIFICATION_SOURCE_SECURITY: "WLAN_NOTIFICATION_SOURCE_SECURITY",
WLAN_NOTIFICATION_SOURCE_IHV: "WLAN_NOTIFICATION_SOURCE_IHV",
WLAN_NOTIFICATION_SOURCE_HNWK: "WLAN_NOTIFICATION_SOURCE_HNWK",
WLAN_NOTIFICATION_SOURCE_ALL: "WLAN_NOTIFICATION_SOURCE_ALL",
}
class ONEX_NOTIFICATION_TYPE_ENUM(Enum):
OneXPublicNotificationBase = 0
OneXNotificationTypeResultUpdate = 1
OneXNotificationTypeAuthRestarted = 2
OneXNotificationTypeEventInvalid = 3
OneXNumNotifications = OneXNotificationTypeEventInvalid
class WLAN_NOTIFICATION_ACM_ENUM(Enum):
wlan_notification_acm_start = 0
wlan_notification_acm_autoconf_enabled = 1
wlan_notification_acm_autoconf_disabled = 2
wlan_notification_acm_background_scan_enabled = 3
wlan_notification_acm_background_scan_disabled = 4
wlan_notification_acm_bss_type_change = 5
wlan_notification_acm_power_setting_change = 6
wlan_notification_acm_scan_complete = 7
wlan_notification_acm_scan_fail = 8
wlan_notification_acm_connection_start = 9
wlan_notification_acm_connection_complete = 10
wlan_notification_acm_connection_attempt_fail = 11
wlan_notification_acm_filter_list_change = 12
wlan_notification_acm_interface_arrival = 13
wlan_notification_acm_interface_removal = 14
wlan_notification_acm_profile_change = 15
wlan_notification_acm_profile_name_change = 16
wlan_notification_acm_profiles_exhausted = 17
wlan_notification_acm_network_not_available = 18
wlan_notification_acm_network_available = 19
wlan_notification_acm_disconnecting = 20
wlan_notification_acm_disconnected = 21
wlan_notification_acm_adhoc_network_state_change = 22
wlan_notification_acm_profile_unblocked = 23
wlan_notification_acm_screen_power_change = 24
wlan_notification_acm_profile_blocked = 25
wlan_notification_acm_scan_list_refresh = 26
wlan_notification_acm_end = 27
class WLAN_NOTIFICATION_MSM_ENUM(Enum):
wlan_notification_msm_start = 0
wlan_notification_msm_associating = 1
wlan_notification_msm_associated = 2
wlan_notification_msm_authenticating = 3
wlan_notification_msm_connected = 4
wlan_notification_msm_roaming_start = 5
wlan_notification_msm_roaming_end = 6
wlan_notification_msm_radio_state_change = 7
wlan_notification_msm_signal_quality_change = 8
wlan_notification_msm_disassociating = 9
wlan_notification_msm_disconnected = 10
wlan_notification_msm_peer_join = 11
wlan_notification_msm_peer_leave = 12
wlan_notification_msm_adapter_removal = 13
wlan_notification_msm_adapter_operation_mode_change = 14
wlan_notification_msm_end = 15
class WLAN_HOSTED_NETWORK_NOTIFICATION_CODE_ENUM(Enum):
wlan_hosted_network_state_change = 4096
wlan_hosted_network_peer_state_change = 4097
wlan_hosted_network_radio_state_change = 4098
WLAN_CONNECTION_MODE = c_uint
WLAN_CONNECTION_MODE_KV = {0: "wlan_connection_mode_profile",
1: "wlan_connection_mode_temporary_profile",
2: "wlan_connection_mode_discovery_secure",
3: "wlan_connection_mode_discovery_unsecure",
4: "wlan_connection_mode_auto",
5: "wlan_connection_mode_invalid"}
try:
WLAN_CONNECTION_MODE_VK = { v: k for k, v in
WLAN_CONNECTION_MODE_KV.items() }
except AttributeError:
WLAN_CONNECTION_MODE_VK = { v: k for k, v in
WLAN_CONNECTION_MODE_KV.iteritems() }
class WLAN_INTERFACE_INFO(Structure):
"""
The WLAN_INTERFACE_INFO structure contains information about a wireless
LAN interface.
typedef struct _WLAN_INTERFACE_INFO {
GUID InterfaceGuid;
WCHAR strInterfaceDescription[256];
WLAN_INTERFACE_STATE isState;
} WLAN_INTERFACE_INFO, *PWLAN_INTERFACE_INFO;
"""
_fields_ = [("InterfaceGuid", GUID),
("strInterfaceDescription", c_wchar * 256),
("isState", WLAN_INTERFACE_STATE)]
class WLAN_INTERFACE_INFO_LIST(Structure):
"""
The WLAN_INTERFACE_INFO_LIST structure contains an array of NIC
interface information.
typedef struct _WLAN_INTERFACE_INFO_LIST {
DWORD dwNumberOfItems;
DWORD dwIndex;
WLAN_INTERFACE_INFO InterfaceInfo[];
} WLAN_INTERFACE_INFO_LIST, *PWLAN_INTERFACE_INFO_LIST;
"""
_fields_ = [("NumberOfItems", DWORD),
("Index", DWORD),
("InterfaceInfo", WLAN_INTERFACE_INFO * 1)]
class WLAN_PHY_RADIO_STATE(Structure):
"""
"""
_fields_ = [("dwPhyIndex", DWORD),
("dot11SoftwareRadioState", DOT11_RADIO_STATE),
("dot11HardwareRadioState", DOT11_RADIO_STATE)]
class WLAN_RADIO_STATE(Structure):
"""
The WLAN_RADIO_STATE structure specifies the radio state on a list
of physical layer (PHY) types.
typedef struct _WLAN_RADIO_STATE {
DWORD dwNumberOfPhys;
WLAN_PHY_RADIO_STATE PhyRadioState[64];
} WLAN_RADIO_STATE, *PWLAN_RADIO_STATE
"""
_fields_ = [("dwNumberOfPhys", DWORD),
("PhyRadioState", WLAN_PHY_RADIO_STATE * 64)]
class DOT11_SSID(Structure):
"""
A DOT11_SSID structure contains the SSID of an interface.
typedef struct _DOT11_SSID {
ULONG uSSIDLength;
UCHAR ucSSID[DOT11_SSID_MAX_LENGTH];
} DOT11_SSID, *PDOT11_SSID;
"""
_fields_ = [("SSIDLength", c_ulong),
("SSID", c_char * DOT11_SSID_MAX_LENGTH)]
class WLAN_RAW_DATA(Structure):
"""
The WLAN_RAW_DATA structure contains raw data in the form of a blob
that is used by some Native Wifi functions.
typedef struct _WLAN_RAW_DATA {
DWORD dwDataSize;
BYTE DataBlob[1];
} WLAN_RAW_DATA, *PWLAN_RAW_DATA;
"""
_fields_ = [("DataSize", DWORD),
("DataBlob", c_byte * 1)]
class WLAN_RATE_SET(Structure):
"""
typedef struct _WLAN_RATE_SET {
ULONG uRateSetLength;
USHORT usRateSet[DOT11_RATE_SET_MAX_LENGTH];
} WLAN_RATE_SET, *PWLAN_RATE_SET;
"""
_fields_ = [("RateSetLength", c_ulong),
("RateSet", c_ushort * DOT11_RATE_SET_MAX_LENGTH)]
class WLAN_BSS_ENTRY(Structure):
"""
The WLAN_BSS_ENTRY structure contains information about a basic service
set (BSS).
typedef struct _WLAN_BSS_ENTRY {
DOT11_SSID dot11Ssid;
ULONG uPhyId;
DOT11_MAC_ADDRESS dot11Bssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_PHY_TYPE dot11BssPhyType;
LONG lRssi;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG ulChCenterFrequency;
WLAN_RATE_SET wlanRateSet;
ULONG ulIeOffset;
ULONG ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;
"""
_fields_ = [("dot11Ssid", DOT11_SSID),
("PhyId", c_ulong),
("dot11Bssid", DOT11_MAC_ADDRESS),
("dot11BssType", DOT11_BSS_TYPE),
("dot11BssPhyType", DOT11_PHY_TYPE),
("Rssi", c_long),
("LinkQuality", c_ulong),
("InRegDomain", BOOL),
("BeaconPeriod", c_ushort),
("Timestamp", c_ulonglong),
("HostTimestamp", c_ulonglong),
("CapabilityInformation", c_ushort),
("ChCenterFrequency", c_ulong),
("wlanRateSet", WLAN_RATE_SET),
("IeOffset", c_ulong),
("IeSize", c_ulong)]
class WLAN_BSS_LIST(Structure):
"""
The WLAN_BSS_LIST structure contains a list of basic service set (BSS)
entries.
typedef struct _WLAN_BSS_LIST {
DWORD dwTotalSize;
DWORD dwNumberOfItems;
WLAN_BSS_ENTRY wlanBssEntries[1];
} WLAN_BSS_LIST, *PWLAN_BSS_LIST;
"""
_fields_ = [("TotalSize", DWORD),
("NumberOfItems", DWORD),
("wlanBssEntries", WLAN_BSS_ENTRY * 1)]
class WLAN_AVAILABLE_NETWORK(Structure):
"""
The WLAN_AVAILABLE_NETWORK structure contains information about an
available wireless network.
typedef struct _WLAN_AVAILABLE_NETWORK {
WCHAR strProfileName[256];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
ULONG uNumberOfBssids;
BOOL bNetworkConnectable;
WLAN_REASON_CODE wlanNotConnectableReason;
ULONG uNumberOfPhyTypes;
DOT11_PHY_TYPE dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
BOOL bMorePhyTypes;
WLAN_SIGNAL_QUALITY wlanSignalQuality;
BOOL bSecurityEnabled;
DOT11_AUTH_ALGORITHM dot11DefaultAuthAlgorithm;
DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
DWORD dwFlags;
DWORD dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;
"""
_fields_ = [("ProfileName", c_wchar * 256),
("dot11Ssid", DOT11_SSID),
("dot11BssType", DOT11_BSS_TYPE),
("NumberOfBssids", c_ulong),
("NetworkConnectable", BOOL),
("wlanNotConnectableReason", WLAN_REASON_CODE),
("NumberOfPhyTypes", c_ulong),
("dot11PhyTypes", DOT11_PHY_TYPE * WLAN_MAX_PHY_TYPE_NUMBER),
("MorePhyTypes", BOOL),
("wlanSignalQuality", WLAN_SIGNAL_QUALITY),
("SecurityEnabled", BOOL),
("dot11DefaultAuthAlgorithm", DOT11_AUTH_ALGORITHM_TYPE),
("dot11DefaultCipherAlgorithm", DOT11_CIPHER_ALGORITHM_TYPE),
("Flags", DWORD),
("Reserved", DWORD)]
class WLAN_AVAILABLE_NETWORK_LIST(Structure):
"""
The WLAN_AVAILABLE_NETWORK_LIST structure contains an array of
information about available networks.
typedef struct _WLAN_AVAILABLE_NETWORK_LIST {
DWORD dwNumberOfItems;
DWORD dwIndex;
WLAN_AVAILABLE_NETWORK Network[1];
} WLAN_AVAILABLE_NETWORK_LIST, *PWLAN_AVAILABLE_NETWORK_LIST;
"""
_fields_ = [("NumberOfItems", DWORD),
("Index", DWORD),
("Network", WLAN_AVAILABLE_NETWORK * 1)]
class WLAN_PROFILE_INFO(Structure):
"""
The WLAN_PROFILE_INFO structure contains basic information about a
profile.
typedef struct _WLAN_PROFILE_INFO {
WCHAR strProfileName[256];
DWORD dwFlags;
} WLAN_PROFILE_INFO, *PWLAN_PROFILE_INFO;
"""
_fields_ = [("ProfileName", c_wchar * 256),
("Flags", DWORD)]
class WLAN_PROFILE_INFO_LIST(Structure):
"""
The WLAN_PROFILE_INFO_LIST structure contains a list of wireless
profile information.
typedef struct _WLAN_PROFILE_INFO_LIST {
DWORD dwNumberOfItems;
DWORD dwIndex;
WLAN_PROFILE_INFO ProfileInfo[1];
} WLAN_PROFILE_INFO_LIST, *PWLAN_PROFILE_INFO_LIST;
"""
_fields_ = [("NumberOfItems", DWORD),
("Index", DWORD),
("ProfileInfo", WLAN_PROFILE_INFO * 1)]
class WLAN_NOTIFICATION_DATA(Structure):
"""
The WLAN_NOTIFICATION_DATA structure contains information provided
when receiving notifications.
typedef struct _WLAN_NOTIFICATION_DATA {
DWORD NotificationSource;
DWORD NotificationCode;
GUID InterfaceGuid;
DWORD dwDataSize;
PVOID pData;
} WLAN_NOTIFICATION_DATA, *PWLAN_NOTIFICATION_DATA;
"""
_fields_ = [("NotificationSource", DWORD),
("NotificationCode", DWORD),
("InterfaceGuid", GUID),
("dwDataSize", DWORD),
("pData", c_void_p)]
class WLAN_NOTIFICATION_CALLBACK():
"""
The WLAN_NOTIFICATION_CALLBACK allback function prototype defines
the type of notification callback function.
typedef VOID ( WINAPI *WLAN_NOTIFICATION_CALLBACK)(
PWLAN_NOTIFICATION_DATA data,
PVOID context
);
"""
_fields_ = [("data", POINTER(WLAN_NOTIFICATION_DATA)),
("context", c_void_p)]
class WLAN_MSM_NOTIFICATION_DATA(Structure):
"""
typedef struct _WLAN_MSM_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_MAC_ADDRESS dot11MacAddr;
BOOL bSecurityEnabled;
BOOL bFirstPeer;
BOOL bLastPeer;
WLAN_REASON_CODE wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;
"""
_fields_ = [("wlanConnectionMode", WLAN_CONNECTION_MODE),
("strProfileName", c_wchar * 256),
("dot11Ssid", DOT11_SSID),
("dot11BssType", DOT11_BSS_TYPE),
("dot11MacAddr", DOT11_MAC_ADDRESS),
("bSecurityEnabled", BOOL),
("bFirstPeer", BOOL),
("bLastPeer", BOOL),
("wlanReasonCode", WLAN_REASON_CODE),]
WLAN_NOTIFICATION_DATA_MSM_TYPES_DICT = {
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_associating: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_associated: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_authenticating: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_connected: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_roaming_start: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_roaming_end: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_radio_state_change: None,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_signal_quality_change: c_ulong,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_disassociating: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_disconnected: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_peer_join: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_peer_leave: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_adapter_removal: WLAN_MSM_NOTIFICATION_DATA,
WLAN_NOTIFICATION_MSM_ENUM.wlan_notification_msm_adapter_operation_mode_change: c_ulong,
}
class WLAN_CONNECTION_NOTIFICATION_DATA(Structure):
"""
typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
BOOL bSecurityEnabled;
WLAN_REASON_CODE wlanReasonCode;
DWORD dwFlags;
WCHAR strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;
"""
_fields_ = [("wlanConnectionMode", WLAN_CONNECTION_MODE),
("strProfileName", c_wchar * 256),
("dot11Ssid", DOT11_SSID),
("dot11BssType", DOT11_BSS_TYPE),
("bSecurityEnabled", BOOL),
("wlanReasonCode", WLAN_REASON_CODE),
("dwFlags", DWORD),
("strProfileXml", (c_wchar * 1)),]
WLAN_NOTIFICATION_DATA_ACM_TYPES_DICT = {
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_autoconf_enabled: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_autoconf_disabled: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_background_scan_enabled: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_background_scan_disabled: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_bss_type_change: DOT11_BSS_TYPE,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_power_setting_change: None, # TODO: Change to WLAN_POWER_SETTING
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_scan_complete: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_scan_fail: WLAN_REASON_CODE,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_connection_start: WLAN_CONNECTION_NOTIFICATION_DATA,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_connection_complete: WLAN_CONNECTION_NOTIFICATION_DATA,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_connection_attempt_fail: WLAN_CONNECTION_NOTIFICATION_DATA,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_filter_list_change: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_interface_arrival: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_interface_removal: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_profile_change: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_profile_name_change: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_profiles_exhausted: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_network_not_available: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_network_available: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_disconnecting: WLAN_CONNECTION_NOTIFICATION_DATA,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_disconnected: WLAN_CONNECTION_NOTIFICATION_DATA,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_adhoc_network_state_change: None, # TODO: Change to WLAN_ADHOC_NETWORK_STATE
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_profile_unblocked: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_screen_power_change: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_profile_blocked: None,
WLAN_NOTIFICATION_ACM_ENUM.wlan_notification_acm_scan_list_refresh: None,
}
def WlanRegisterNotification(hClientHandle, callback):
"""
The WlanRegisterNotification function is used to register and
unregister notifications on all wireless interfaces.
DWORD WINAPI WlanRegisterNotification(
_In_ HANDLE hClientHandle,
_In_ DWORD dwNotifSource,
_In_ BOOL bIgnoreDuplicate,
_In_opt_ WLAN_NOTIFICATION_CALLBACK funcCallback,
_In_opt_ PVOID pCallbackContext,
_Reserved_ PVOID pReserved,
_Out_opt_ PDWORD pdwPrevNotifSource
);
"""
WLAN_NOTIFICATION_CALLBACK_M = CFUNCTYPE(None, # type for return value
POINTER(WLAN_NOTIFICATION_DATA),
c_void_p,
use_last_error=True)
func_ref = wlanapi.WlanRegisterNotification
func_ref.argtypes = [
HANDLE,
DWORD,
BOOL,
WLAN_NOTIFICATION_CALLBACK_M,
c_void_p,
c_void_p,
POINTER(DWORD)]
func_ref.restype = DWORD
dwNotifSource = WLAN_NOTIFICATION_SOURCE_ALL
bIgnoreDuplicate = True
funcCallback = WLAN_NOTIFICATION_CALLBACK_M(callback)
pCallbackContext = None
pdwPrevNotifSource = None
result = func_ref(hClientHandle,
dwNotifSource,
bIgnoreDuplicate,
funcCallback,
pCallbackContext,
None,
pdwPrevNotifSource)
if result != ERROR_SUCCESS:
raise WinError(result)
return funcCallback
def WlanOpenHandle():
"""
The WlanOpenHandle function opens a connection to the server.
DWORD WINAPI WlanOpenHandle(
_In_ DWORD dwClientVersion,
_Reserved_ PVOID pReserved,
_Out_ PDWORD pdwNegotiatedVersion,
_Out_ PHANDLE phClientHandle
);
"""
func_ref = wlanapi.WlanOpenHandle
func_ref.argtypes = [DWORD, c_void_p, POINTER(DWORD), POINTER(HANDLE)]
func_ref.restype = DWORD
negotiated_version = DWORD()
client_handle = HANDLE()
result = func_ref(2, None, byref(negotiated_version), byref(client_handle))
if result != ERROR_SUCCESS:
raise Exception("WlanOpenHandle failed.")
return client_handle
def WlanCloseHandle(hClientHandle):
"""
The WlanCloseHandle function closes a connection to the server.
DWORD WINAPI WlanCloseHandle(
_In_ HANDLE hClientHandle,
_Reserved_ PVOID pReserved
);
"""
func_ref = wlanapi.WlanCloseHandle
func_ref.argtypes = [HANDLE, c_void_p]
func_ref.restype = DWORD
result = func_ref(hClientHandle, None)
if result != ERROR_SUCCESS:
raise Exception("WlanCloseHandle failed.")
return result
def WlanFreeMemory(pMemory):
"""
The WlanFreeMemory function frees memory. Any memory returned from
Native Wifi functions must be freed.
VOID WINAPI WlanFreeMemory(
_In_ PVOID pMemory
);
"""
func_ref = wlanapi.WlanFreeMemory
func_ref.argtypes = [c_void_p]
func_ref(pMemory)
def WlanEnumInterfaces(hClientHandle):
"""
The WlanEnumInterfaces function enumerates all of the wireless LAN
interfaces currently enabled on the local computer.
DWORD WINAPI WlanEnumInterfaces(
_In_ HANDLE hClientHandle,
_Reserved_ PVOID pReserved,
_Out_ PWLAN_INTERFACE_INFO_LIST *ppInterfaceList
);
"""
func_ref = wlanapi.WlanEnumInterfaces
func_ref.argtypes = [HANDLE,
c_void_p,
POINTER(POINTER(WLAN_INTERFACE_INFO_LIST))]
func_ref.restype = DWORD
wlan_ifaces = pointer(WLAN_INTERFACE_INFO_LIST())
result = func_ref(hClientHandle, None, byref(wlan_ifaces))
if result != ERROR_SUCCESS:
raise Exception("WlanEnumInterfaces failed.")
return wlan_ifaces
def WlanScan(hClientHandle, pInterfaceGuid, ssid=""):
"""
The WlanScan function requests a scan for available networks on the
indicated interface.
DWORD WINAPI WlanScan(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_opt_ const PDOT11_SSID pDot11Ssid,
_In_opt_ const PWLAN_RAW_DATA pIeData,
_Reserved_ PVOID pReserved
);
"""
func_ref = wlanapi.WlanScan
func_ref.argtypes = [HANDLE,
POINTER(GUID),
POINTER(DOT11_SSID),
POINTER(WLAN_RAW_DATA),
c_void_p]
func_ref.restype = DWORD
if ssid:
length = len(ssid)
if length > DOT11_SSID_MAX_LENGTH:
raise Exception("SSIDs have a maximum length of 32 characters.")
# data = tuple(ord(char) for char in ssid)
data = ssid
dot11_ssid = byref(DOT11_SSID(length, data))
else:
dot11_ssid = None
# TODO: Support WLAN_RAW_DATA argument.
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
dot11_ssid,
None,
None)
if result != ERROR_SUCCESS:
raise Exception("WlanScan failed.")
return result
def WlanGetNetworkBssList(hClientHandle, pInterfaceGuid):
"""
The WlanGetNetworkBssList function retrieves a list of the basic
service set (BSS) entries of the wireless network or networks on a
given wireless LAN interface.
DWORD WINAPI WlanGetNetworkBssList(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ const PDOT11_SSID pDot11Ssid,
_In_ DOT11_BSS_TYPE dot11BssType,
_In_ BOOL bSecurityEnabled,
_Reserved_ PVOID pReserved,
_Out_ PWLAN_BSS_LIST *ppWlanBssList
);
"""
func_ref = wlanapi.WlanGetNetworkBssList
# TODO: handle the arguments descibed below.
# pDot11Ssid - When set to NULL, the returned list contains all of
# available BSS entries on a wireless LAN interface.
# dot11BssType - The BSS type of the network. This parameter is ignored if
# the SSID of the network for the BSS list is unspecified (the pDot11Ssid
# parameter is NULL).
# bSecurityEnabled - A value that indicates whether security is enabled on
# the network. This parameter is only valid when the SSID of the network
# for the BSS list is specified (the pDot11Ssid parameter is not NULL).
func_ref.argtypes = [HANDLE,
POINTER(GUID),
c_void_p,
c_void_p,
c_void_p,
c_void_p,
POINTER(POINTER(WLAN_BSS_LIST))]
func_ref.restype = DWORD
wlan_bss_list = pointer(WLAN_BSS_LIST())
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
None,
None,
None,
None,
byref(wlan_bss_list))
if result != ERROR_SUCCESS:
raise Exception("WlanGetNetworkBssList failed.")
return wlan_bss_list
def WlanGetAvailableNetworkList(hClientHandle, pInterfaceGuid):
"""
The WlanGetAvailableNetworkList function retrieves the list of
available networks on a wireless LAN interface.
DWORD WINAPI WlanGetAvailableNetworkList(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ DWORD dwFlags,
_Reserved_ PVOID pReserved,
_Out_ PWLAN_AVAILABLE_NETWORK_LIST *ppAvailableNetworkList
);
"""
func_ref = wlanapi.WlanGetAvailableNetworkList
func_ref.argtypes = [HANDLE,
POINTER(GUID),
DWORD,
c_void_p,
POINTER(POINTER(WLAN_AVAILABLE_NETWORK_LIST))]
func_ref.restype = DWORD
wlan_available_network_list = pointer(WLAN_AVAILABLE_NETWORK_LIST())
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
0,
None,
byref(wlan_available_network_list))
if result != ERROR_SUCCESS:
raise Exception("WlanGetAvailableNetworkList failed.")
return wlan_available_network_list
def WlanGetProfileList(hClientHandle, pInterfaceGuid):
"""
The WlanGetProfileList function retrieves the list of profiles in
preference order.
DWORD WINAPI WlanGetProfileList(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_Reserved_ PVOID pReserved,
_Out_ PWLAN_PROFILE_INFO_LIST *ppProfileList
);
"""
func_ref = wlanapi.WlanGetProfileList
func_ref.argtypes = [HANDLE,
POINTER(GUID),
c_void_p,
POINTER(POINTER(WLAN_PROFILE_INFO_LIST))]
func_ref.restype = DWORD
wlan_profile_info_list = pointer(WLAN_PROFILE_INFO_LIST())
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
None,
byref(wlan_profile_info_list))
if result != ERROR_SUCCESS:
raise Exception("WlanGetProfileList failed.")
return wlan_profile_info_list
def WlanGetProfile(hClientHandle, pInterfaceGuid, profileName):
"""
The WlanGetProfile function retrieves all information about a specified
wireless profile.
DWORD WINAPI WlanGetProfile(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ LPCWSTR strProfileName,
_Reserved_ PVOID pReserved,
_Out_ LPWSTR *pstrProfileXml,
_Inout_opt_ DWORD *pdwFlags,
_Out_opt_ PDWORD pdwGrantedAccess
);
"""
func_ref = wlanapi.WlanGetProfile
func_ref.argtypes = [HANDLE,
POINTER(GUID),
LPCWSTR,
c_void_p,
POINTER(LPWSTR),
POINTER(DWORD),
POINTER(DWORD)]
func_ref.restype = DWORD
pdw_granted_access = DWORD()
xml = LPWSTR()
flags = DWORD(WLAN_PROFILE_GET_PLAINTEXT_KEY)
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
profileName,
None,
byref(xml),
byref(flags),
byref(pdw_granted_access))
if result != ERROR_SUCCESS:
raise Exception("WlanGetProfile failed.")
return xml
def WlanDeleteProfile(hClientHandle, pInterfaceGuid, profileName):
"""
DWORD WINAPI WlanDeleteProfile(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ LPCWSTR strProfileName,
_Reserved_ PVOID pReserved
);
"""
func_ref = wlanapi.WlanDeleteProfile
func_ref.argtypes = [HANDLE,
POINTER(GUID),
LPCWSTR,
c_void_p]
func_ref.restype = DWORD
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
profileName,
None)
if result != ERROR_SUCCESS:
raise Exception("WlanDeleteProfile failed. error %d" % result, result)
return result
class NDIS_OBJECT_HEADER(Structure):
"""
The NDIS_OBJECT_HEADER structure packages the object type, version, and
size information that is required in many NDIS 6.0 structures.
typedef struct _NDIS_OBJECT_HEADER {
UCHAR Type;
UCHAR Revision;
USHORT Size;
} NDIS_OBJECT_HEADER, *PNDIS_OBJECT_HEADER;
"""
_fields_ = [("Type", c_char),
("Revision", c_char),
("Size", c_ushort)]
class DOT11_BSSID_LIST(Structure):
"""
The DOT11_BSSID_LIST structure contains a list of basic service set
(BSS) identifiers.
typedef struct _DOT11_BSSID_LIST {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_MAC_ADDRESS BSSIDs[1];
} DOT11_BSSID_LIST, *PDOT11_BSSID_LIST;
"""
#NOTE: Would benefit from dynamic instantiation to mod # of BSSIDs
_fields_ = [("Header", NDIS_OBJECT_HEADER),
("uNumOfEntries", c_ulong),
("uTotalNumOfEntries", c_ulong),
("BSSIDs", DOT11_MAC_ADDRESS * 1)]
class WLAN_CONNECTION_PARAMETERS(Structure):
"""
The WLAN_CONNECTION_PARAMETERS structure specifies the parameters used
when using the WlanConnect function.
typedef struct _WLAN_CONNECTION_PARAMETERS {
WLAN_CONNECTION_MODE wlanConnectionMode;
LPCWSTR strProfile;
PDOT11_SSID pDot11Ssid;
PDOT11_BSSID_LIST pDesiredBssidList;
DOT11_BSS_TYPE dot11BssType;
DWORD dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;
"""
"""
Re strProfile:
If wlanConnectionMode is set to wlan_connection_mode_profile, then
strProfile specifies the name of the profile used for the connection.
If wlanConnectionMode is set to wlan_connection_mode_temporary_profile,
then strProfile specifies the XML representation of the profile used for
the connection. If wlanConnectionMode is set to
wlan_connection_mode_discovery_secure or wlan_connection_mode_discovery_unsecure,
then strProfile should be set to NULL.
NOTE: For now, only profile names will be accepted, per strProfileName
elsewhere.
"""
_fields_ = [("wlanConnectionMode", WLAN_CONNECTION_MODE),
("strProfile", LPCWSTR),
("pDot11_ssid", POINTER(DOT11_SSID)),
("pDesiredBssidList", POINTER(DOT11_BSSID_LIST)),
("dot11BssType", DOT11_BSS_TYPE),
("dwFlags", DWORD)]
def WlanConnect(hClientHandle, pInterfaceGuid, pConnectionParameters):
"""
The WlanConnect function attempts to connect to a specific network.
DWORD WINAPI WlanConnect(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
_Reserved_ PVOID pReserved
);
"""
func_ref = wlanapi.WlanConnect
func_ref.argtypes = [HANDLE,
POINTER(GUID),
POINTER(WLAN_CONNECTION_PARAMETERS),
c_void_p]
func_ref.restype = DWORD
result = func_ref(hClientHandle,
pointer(pInterfaceGuid),
pointer(pConnectionParameters),
None)
if result != ERROR_SUCCESS:
raise Exception("".join(["WlanConnect failed with error ", str(result)]))
return result
def WlanDisconnect(hClientHandle, pInterfaceGuid):
"""
"""
func_ref = wlanapi.WlanDisconnect
func_ref.argtypes = [HANDLE,
POINTER(GUID),
c_void_p]
func_ref.restype = DWORD
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
None)
if result != ERROR_SUCCESS:
raise Exception("WlanDisconnect failed.")
return result
WLAN_INTF_OPCODE = c_uint
WLAN_INTF_OPCODE_DICT = {
0x000000000: "wlan_intf_opcode_autoconf_start",
1: "wlan_intf_opcode_autoconf_enabled",
2: "wlan_intf_opcode_background_scan_enabled",
3: "wlan_intf_opcode_media_streaming_mode",
4: "wlan_intf_opcode_radio_state",
5: "wlan_intf_opcode_bss_type",
6: "wlan_intf_opcode_interface_state",
7: "wlan_intf_opcode_current_connection",
8: "wlan_intf_opcode_channel_number",
9: "wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs",
10: "wlan_intf_opcode_supported_adhoc_auth_cipher_pairs",
11: "wlan_intf_opcode_supported_country_or_region_string_list",
12: "wlan_intf_opcode_current_operation_mode",
13: "wlan_intf_opcode_supported_safe_mode",
14: "wlan_intf_opcode_certified_safe_mode",
15: "wlan_intf_opcode_hosted_network_capable",
16: "wlan_intf_opcode_management_frame_protection_capable",
0x0fffffff: "wlan_intf_opcode_autoconf_end",
0x10000100: "wlan_intf_opcode_msm_start",
17: "wlan_intf_opcode_statistics",
18: "wlan_intf_opcode_rssi",
0x1fffffff: "wlan_intf_opcode_msm_end",
0x20010000: "wlan_intf_opcode_security_start",
0x2fffffff: "wlan_intf_opcode_security_end",
0x30000000: "wlan_intf_opcode_ihv_start",
0x3fffffff: "wlan_intf_opcode_ihv_end"
}
WLAN_OPCODE_VALUE_TYPE = c_uint
WLAN_OPCODE_VALUE_TYPE_DICT = {
0: "wlan_opcode_value_type_query_only",
1: "wlan_opcode_value_type_set_by_group_policy",
2: "wlan_opcode_value_type_set_by_user",
3: "wlan_opcode_value_type_invalid"
}
class WLAN_ASSOCIATION_ATTRIBUTES(Structure):
"""
"""
_fields_ = [("dot11Ssid", DOT11_SSID),
("dot11BssType", DOT11_BSS_TYPE),
("dot11Bssid", DOT11_MAC_ADDRESS),
("dot11PhyType", DOT11_PHY_TYPE),
("uDot11PhyIndex", c_ulong),
("wlanSignalQuality", WLAN_SIGNAL_QUALITY),
("ulRxRate", c_ulong),
("ulTxRate", c_ulong)]
class WLAN_SECURITY_ATTRIBUTES(Structure):
"""
"""
_fields_ = [("bSecurityEnabled", BOOL),
("bOneXEnabled", BOOL),
("dot11AuthAlgorithm", DOT11_AUTH_ALGORITHM_TYPE),
("dot11CipherAlgorithm", DOT11_CIPHER_ALGORITHM_TYPE)]
class WLAN_CONNECTION_ATTRIBUTES(Structure):
"""
The WlanQueryInterface function queries various parameters of a
specified interface.
typedef struct _WLAN_CONNECTION_ATTRIBUTES {
WLAN_INTERFACE_STATE isState;
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[256];
WLAN_ASSOCIATION_ATTRIBUTES wlanAssociationAttributes;
WLAN_SECURITY_ATTRIBUTES wlanSecurityAttributes;
} WLAN_CONNECTION_ATTRIBUTES, *PWLAN_CONNECTION_ATTRIBUTES;
"""
_fields_ = [("isState", WLAN_INTERFACE_STATE),
("wlanConnectionMode", WLAN_CONNECTION_MODE),
("strProfileName", c_wchar * 256),
("wlanAssociationAttributes", WLAN_ASSOCIATION_ATTRIBUTES),
("wlanSecurityAttributes", WLAN_SECURITY_ATTRIBUTES)]
WLAN_INTF_OPCODE_TYPE_DICT = {
"wlan_intf_opcode_autoconf_enabled": c_bool,
"wlan_intf_opcode_background_scan_enabled": c_bool,
"wlan_intf_opcode_radio_state": WLAN_RADIO_STATE,
"wlan_intf_opcode_bss_type": DOT11_BSS_TYPE,
"wlan_intf_opcode_interface_state": WLAN_INTERFACE_STATE,
"wlan_intf_opcode_current_connection": WLAN_CONNECTION_ATTRIBUTES,
"wlan_intf_opcode_channel_number": c_ulong,
#"wlan_intf_opcode_supported_infrastructure_auth_cipher_pairs": \
#WLAN_AUTH_CIPHER_PAIR_LIST,
#"wlan_intf_opcode_supported_adhoc_auth_cipher_pairs": \
#WLAN_AUTH_CIPHER_PAIR_LIST,
#"wlan_intf_opcode_supported_country_or_region_string_list": \
#WLAN_COUNTRY_OR_REGION_STRING_LIST,
"wlan_intf_opcode_media_streaming_mode": c_bool,
#"wlan_intf_opcode_statistics": WLAN_STATISTICS,
"wlan_intf_opcode_rssi": c_long,
"wlan_intf_opcode_current_operation_mode": c_ulong,
"wlan_intf_opcode_supported_safe_mode": c_bool,
"wlan_intf_opcode_certified_safe_mode": c_bool
}
def WlanQueryInterface(hClientHandle, pInterfaceGuid, OpCode):
"""
DWORD WINAPI WlanQueryInterface(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ WLAN_INTF_OPCODE OpCode,
_Reserved_ PVOID pReserved,
_Out_ PDWORD pdwDataSize,
_Out_ PVOID *ppData,
_Out_opt_ PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);
"""
func_ref = wlanapi.WlanQueryInterface
#TODO: Next two lines sketchy due to incomplete implementation.
opcode_name = WLAN_INTF_OPCODE_DICT[OpCode.value]
return_type = WLAN_INTF_OPCODE_TYPE_DICT[opcode_name]
func_ref.argtypes = [HANDLE,
POINTER(GUID),
WLAN_INTF_OPCODE,
c_void_p,
POINTER(DWORD),
POINTER(POINTER(return_type)),
POINTER(WLAN_OPCODE_VALUE_TYPE)]
func_ref.restype = DWORD
pdwDataSize = DWORD()
ppData = pointer(return_type())
pWlanOpcodeValueType = WLAN_OPCODE_VALUE_TYPE()
result = func_ref(hClientHandle,
byref(pInterfaceGuid),
OpCode,
None,
pdwDataSize,
ppData,
pWlanOpcodeValueType)
if result != ERROR_SUCCESS:
raise Exception("WlanQueryInterface failed.")
return ppData
