
Chapter 7 — Programming
164 CN2B Mobile Computer User’s Manual
GetAuthenticationMode()
Call this function to obtain the radio’s current authentication mode.
Syntax UINT GetAuthenticationMode( ULONG & );
Parameters NDIS_RADIO_AUTH_MODE_OPEN 802.11 Open Authentication. Indicates that
the radio is 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
automatic detection is used when available.
NDIS_RADIO_AUTH_MODE_ERROR Defined as error value. Indicates authentication
mode was not determined 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
set. In ESS mode, this is the MAC address of the access point the radio is
associated with. In IBSS mode, this is a randomly generated MAC address,
and serves as the ID for the IBSS.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetAssociationStatus)(ULONG &);
#else
UINT GetAssociationStatus(ULONG &);
#endif
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
the query failed, or ERR_CONNECT_FAILED if a connection with
the radio failed.
Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated
with the BSSID of the current service set:
xx-xx-xx-xx-xx-xx
Comentarios a estos manuales