Getauthenticationmode(), Getbssid() – Intermec 751G User Manual

Page 94

Advertising
background image

Chapter 3 — Configuring the Computer

80

751G Color Mobile Computer User’s Manual

GetAuthenticationMode()

Call this function to obtain the radio’s current authentication mode.

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 GetAuthenticationMode( ULONG & );

Parameters

NDIS_RADIO_AUTH_MODE_OPEN

802.11b/g Open Authentication. Indicates that the
radio is using an open system.

NDIS_RADIO_AUTH_MODE_SHARED

802.11b/g 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

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

Definitions

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

Advertising