User's Manual

Chapter 7 — Programming
CN30 Mobile Computer User’s Manual 157
typedef UINT (*PFN_RadioDisassociate)();
#else
UINT RadioDisassociate();
#endif
Query Information Functions
GetAssociationStatus()
Call this function to obtain the radio’s current association status with a service set.
Syntax UINT GetAssociationStatus( ULONG & );
Parameters NDIS_RADIO_ASSOCIATED Indicates the radio is associated with an access point
NDIS_RADIO_SCANNING Indicates the radio is looking for an access point with which
to associate
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks Data is only valid if the function returns ERROR_SUCCESS. Also, if ERROR_SUCCESS is returned,
your ULONG reference is populated by one of the parameters listed above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetAssociationStatus)(ULONG &);
#else
UINT GetAssociationStatus(ULONG &);
#endif
GetAuthenticationMode()
Call this function to obtain the radio’s current authentication mode.
Syntax UINT GetAuthenticationMode( ULONG & );
Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.1x Open Authentication. Indicates that
the radio is using an open system.
NDIS_RADIO_AUTH_MODE_SHARED 802.1x Shared Authentication. Indicates that
the radio is using a shared key.
NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates
automatic detection is used when available.
NDIS_RADIO_AUTH_MODE_ERROR Defined as error value. Indicates the authentication
mode was not determined at this
time or is unknown.
NDIS_RADIO_AUTH_MODE_WPA WPA Authentication
NDIS_RADIO_AUTH_MODE_WPA_PSK WPA Preshared Key Authentication
NDIS_RADIO_AUTH_MODE_WPA_NONE WPA None
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks Data is only valid if ERROR_SUCCESS is returned. Also, if ERROR_SUCCESS is returned,
your USHORT reference is populated with one of the parameters listed above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetAuthenticationMode)(ULONG &);
#else
UINT GetAuthenticationMode(ULONG &);
#endif
GetBSSID()
Call this function to get the current MAC address (BSSID) of the service