wlanapi 无线网络编程

/*++ Copyright (c) 2004 Microsoft Corporation Module Name: wlanapi.h Abstract: Definitions and data strcutures for wlan auto config client side API. Environment: User mode only Revision History: 11/8/2004 created --*/ #ifndef _WLAN_WLANAPI_H #define _WLAN_WLANAPI_H #pragma once #include <l2cmn.h> #include <windot11.h> #include <EapTypes.h> #ifdef __cplusplus extern "C" { #endif // major version is in low-order WORD, // minor version is in high-order WORD #define WLAN_API_VERSION_1_0 0x00000001 #define WLAN_API_VERSION_2_0 0x00000002 #define WLAN_API_VERSION_MAJOR(_v) ((_v) & 0xffff) #define WLAN_API_VERSION_MINOR(_v) (((DWORD)(_v)) >> 16) #define WLAN_API_MAKE_VERSION(_major, _minor) (((DWORD)(_minor)) << 16 | (_major)) // WLAN API is version 1 in all WinXP // and version 2 in Longhorn Vista #if (_WIN32_WINNT >= 0x0600) #define WLAN_API_VERSION WLAN_API_VERSION_2_0 #else #define WLAN_API_VERSION WLAN_API_VERSION_1_0 #endif // (_WIN32_WINNT <= 0x0600) // maximum length of name, in characters #define WLAN_MAX_NAME_LENGTH L2_PROFILE_MAX_NAME_LENGTH // profile flags #define WLAN_PROFILE_GROUP_POLICY 0x00000001 #define WLAN_PROFILE_USER 0x00000002 // the following flags are only used for WlanSaveTemporaryProfile API #define WLAN_PROFILE_CONNECTION_MODE_SET_BY_CLIENT 0x00010000 #define WLAN_PROFILE_CONNECTION_MODE_AUTO 0x00020000 // EAPHost data storage flags #define WLAN_SET_EAPHOST_DATA_ALL_USERS 0x00000001 // struct WLAN_PROFILE_INFO defines the basic information of an 802.11 network profile typedef struct _WLAN_PROFILE_INFO { WCHAR strProfileName[WLAN_MAX_NAME_LENGTH]; DWORD dwFlags; } WLAN_PROFILE_INFO, *PWLAN_PROFILE_INFO; typedef struct _DOT11_NETWORK { DOT11_SSID dot11Ssid; DOT11_BSS_TYPE dot11BssType; } DOT11_NETWORK, *PDOT11_NETWORK; // proximity service discovery IE specific definitions // the maximum data size in one PSD IE data entry (payload), in bytes #define DOT11_PSD_IE_MAX_DATA_SIZE 240 // the maximum number of PSD IE data entries #define DOT11_PSD_IE_MAX_ENTRY_NUMBER 5 typedef struct _WLAN_RAW_DATA { // size of the data blob DWORD dwDataSize; #ifdef __midl [unique, size_is(dwDataSize)] BYTE DataBlob[*]; #else BYTE DataBlob[1]; #endif } WLAN_RAW_DATA, *PWLAN_RAW_DATA; typedef struct _WLAN_RAW_DATA_LIST { DWORD dwTotalSize; DWORD dwNumberOfItems; struct { // the beginning of the data blob // the offset is w.r.t. the beginning of the entry DWORD dwDataOffset; // size of the data blob DWORD dwDataSize; } DataList[1]; } WLAN_RAW_DATA_LIST, *PWLAN_RAW_DATA_LIST; typedef enum _WLAN_CONNECTION_MODE { wlan_connection_mode_profile = 0, wlan_connection_mode_temporary_profile, wlan_connection_mode_discovery_secure, wlan_connection_mode_discovery_unsecure, wlan_connection_mode_auto, wlan_connection_mode_invalid } WLAN_CONNECTION_MODE, *PWLAN_CONNECTION_MODE; // Wlan reason code // // They are put in the following range: // each component got 0x1000 numbers, within which: // the first half is for capability mismatch reason, // the second half for connect/security error reason. // // !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! // IMPORTANT: If you add/remove a reason code, please // modify the corresponding entry in wlanres.h and wlanres.rc // and the corresponding mapping in wlanapi.c typedef DWORD WLAN_REASON_CODE, *PWLAN_REASON_CODE; #define WLAN_REASON_CODE_SUCCESS L2_REASON_CODE_SUCCESS // general codes #define WLAN_REASON_CODE_UNKNOWN L2_REASON_CODE_UNKNOWN #define WLAN_REASON_CODE_RANGE_SIZE L2_REASON_CODE_GROUP_SIZE #define WLAN_REASON_CODE_BASE L2_REASON_CODE_DOT11_AC_BASE // range for Auto Config // #define WLAN_REASON_CODE_AC_BASE L2_REASON_CODE_DOT11_AC_BASE #define WLAN_REASON_CODE_AC_CONNECT_BASE (WLAN_REASON_CODE_AC_BASE + WLAN_REASON_CODE_RANGE_SIZE / 2) #define WLAN_REASON_CODE_AC_END (WLAN_REASON_CODE_AC_BASE + WLAN_REASON_CODE_RANGE_SIZE - 1) // range for profile manager // it has profile adding failure reason codes, but may not have // connection reason codes // #define WLAN_REASON_CODE_PROFILE_BASE L2_REASON_CODE_PROFILE_BASE #define WLAN_REASON_CODE_PROFILE_CONNECT_BASE (WLAN_REASON_CODE_PROFILE_BASE + WLAN_REASON_CODE_RANGE_SIZE / 2) #define WLAN_REASON_CODE_PROFILE_END (WLAN_REASON_CODE_PROFILE_BASE + WLAN_REASON_CODE_RANGE_SIZE - 1) // range for MSM // #define WLAN_REASON_CODE_MSM_BASE L2_REASON_CODE_DOT11_MSM_BASE #define WLAN_REASON_CODE_MSM_CONNECT_BASE (WLAN_REASON_CODE_MSM_BASE + WLAN_REASON_CODE_RANGE_SIZE / 2) #define WLAN_REASON_CODE_MSM_END (WLAN_REASON_CODE_MSM_BASE + WLAN_REASON_CODE_RANGE_SIZE - 1) // range for MSMSEC // #define WLAN_REASON_CODE_MSMSEC_BASE L2_REASON_CODE_DOT11_SECURITY_BASE #define WLAN_REASON_CODE_MSMSEC_CONNECT_BASE (WLAN_REASON_CODE_MSMSEC_BASE + WLAN_REASON_CODE_RANGE_SIZE / 2) #define WLAN_REASON_CODE_MSMSEC_END (WLAN_REASON_CODE_MSMSEC_BASE + WLAN_REASON_CODE_RANGE_SIZE - 1) // AC network incompatible reason codes // #define WLAN_REASON_CODE_NETWORK_NOT_COMPATIBLE (WLAN_REASON_CODE_AC_BASE +1) #define WLAN_REASON_CODE_PROFILE_NOT_COMPATIBLE (WLAN_REASON_CODE_AC_BASE +2) // AC connect reason code // #define WLAN_REASON_CODE_NO_AUTO_CONNECTION (WLAN_REASON_CODE_AC_CONNECT_BASE +1) #define WLAN_REASON_CODE_NOT_VISIBLE (WLAN_REASON_CODE_AC_CONNECT_BASE +2) #define WLAN_REASON_CODE_GP_DENIED (WLAN_REASON_CODE_AC_CONNECT_BASE +3) #define WLAN_REASON_CODE_USER_DENIED (WLAN_REASON_CODE_AC_CONNECT_BASE +4) #define WLAN_REASON_CODE_BSS_TYPE_NOT_ALLOWED (WLAN_REASON_CODE_AC_CONNECT_BASE +5) #define WLAN_REASON_CODE_IN_FAILED_LIST (WLAN_REASON_CODE_AC_CONNECT_BASE +6) #define WLAN_REASON_CODE_IN_BLOCKED_LIST (WLAN_REASON_CODE_AC_CONNECT_BASE +7) #define WLAN_REASON_CODE_SSID_LIST_TOO_LONG (WLAN_REASON_CODE_AC_CONNECT_BASE +8) #define WLAN_REASON_CODE_CONNECT_CALL_FAIL (WLAN_REASON_CODE_AC_CONNECT_BASE +9) #define WLAN_REASON_CODE_SCAN_CALL_FAIL (WLAN_REASON_CODE_AC_CONNECT_BASE +10) #define WLAN_REASON_CODE_NETWORK_NOT_AVAILABLE (WLAN_REASON_CODE_AC_CONNECT_BASE +11) #define WLAN_REASON_CODE_PROFILE_CHANGED_OR_DELETED \ (WLAN_REASON_CODE_AC_CONNECT_BASE +12) #define WLAN_REASON_CODE_KEY_MISMATCH (WLAN_REASON_CODE_AC_CONNECT_BASE + 13) #define WLAN_REASON_CODE_USER_NOT_RESPOND (WLAN_REASON_CODE_AC_CONNECT_BASE + 14) // Profile validation errors // #define WLAN_REASON_CODE_INVALID_PROFILE_SCHEMA (WLAN_REASON_CODE_PROFILE_BASE +1) #define WLAN_REASON_CODE_PROFILE_MISSING (WLAN_REASON_CODE_PROFILE_BASE +2) #define WLAN_REASON_CODE_INVALID_PROFILE_NAME (WLAN_REASON_CODE_PROFILE_BASE +3) #define WLAN_REASON_CODE_INVALID_PROFILE_TYPE (WLAN_REASON_CODE_PROFILE_BASE +4) #define WLAN_REASON_CODE_INVALID_PHY_TYPE (WLAN_REASON_CODE_PROFILE_BASE +5) #define WLAN_REASON_CODE_MSM_SECURITY_MISSING (WLAN_REASON_CODE_PROFILE_BASE +6) #define WLAN_REASON_CODE_IHV_SECURITY_NOT_SUPPORTED \ (WLAN_REASON_CODE_PROFILE_BASE +7) #define WLAN_REASON_CODE_IHV_OUI_MISMATCH (WLAN_REASON_CODE_PROFILE_BASE +8) // IHV OUI not present but there is IHV settings in profile #define WLAN_REASON_CODE_IHV_OUI_MISSING (WLAN_REASON_CODE_PROFILE_BASE +9) // IHV OUI is present but there is no IHV settings in profile #define WLAN_REASON_CODE_IHV_SETTINGS_MISSING (WLAN_REASON