Chapter 3 — Configuring the Computer

GetAuthenticationMode()

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

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

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 current service set: xx-xx-xx-xx-xx-xx

Definitions

#ifdef DYNAMIC_LOADING

 

typedef UINT (*PFN_GetBSSID)(TCHAR *);

 

#else

 

UINT GetBSSID(TCHAR *);

 

#endif

80

751G Color Mobile Computer User’s Manual

Page 94
Image 94
Intermec 751G user manual GetBSSID, Uint GetAuthenticationMode Ulong