Getauthenticationmode(), Getbssid() – Intermec 700 User Manual

Page 294

Advertising
background image

Programming

Chapter

7

270

700 Series Color 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 the authen-
tication 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
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.

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 cur-
rent service set:

xx-xx-xx-xx-xx-xx

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetBSSID)(TCHAR *);
#else
UINT GetBSSID(TCHAR *);
#endif

Advertising