ProgrammingChapter —7
270 700Series Color MobileComputer User’s Manual
GetAuthenticationMode()

Call this function to obtain the radio’s curre ntau thentication mode.

Syntax UINT GetAuthenticationMode( ULONG &);
Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11 Open Authentication. Indicates that
the radiois using an open system.
NDIS_RADIO_AUTH_MODE_SHARED 802.11 Shared Authentication. Indicates that
the radio is using a shared key.
NDIS_RADIO_AUTH_MODE_AUTO Auto switch between Open/Shared. Indicates
automaticdetection is used when available.
NDIS_RADIO_AUTH_MODE_ERROR Defined as error value. Indicates the authen-
ticationmode 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 th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks Data is only validif ERROR_SUCCES S is returned. Also, if ERROR_SUCCESS is returned,
your USHORTre ference is populatedwith 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 servi ce

set. In ESS mode, this is the MAC address of the access poin tth e radio is

associatedwith. In IBSS mode, this is a randomly generated MAC address,

andservesastheIDfortheIBSS.

Syntax UINT GetBSSID( TCHAR * );
Parameters Pointer to a character array, which is populated with the current BSSID after a successful call.
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with the BSSID of the cur-
rent service set: xx-xx-xx-xx-xx-xx
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetBSSID)(TCHAR *);
#else
UINT GetBSSID(TCHAR *);
#endif