User's Manual

Programming—Chapter 7
269700 Series Color Mobile Computer User’s Manual
GetMac()
Call this function to get the MAC address of the 802.11b radio.
Syntax UINT GetMac( TCHAR * );
Parameters Pointer to a characte r array, which is populated with the MAC address after a su ccessful 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 retu rned, your TCHAR array is populated with the formatted MAC
address of th e adapter, as follows:
xx-xx-xx-xx-xx-xx
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetMac)(TCHAR *);
#else
UINT GetMac(TCHAR *);
#endif
Note: Be sure to call RadioConnect() before calling this function for this
function to work properly.
GetNetworkMode()
Call this function to get the current Network Mode (SSID) for the
802.11b radio.
Syntax UINT GetNetworkMode( ULONG & );
Parameters NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode.
NDIS_NET_MODE_ESS 802.11 Infrastructure Mode.
NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error
NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supported or
recommended.
NDIS_NET_TYPE_OFDM_5G 5Gigahertz54Mbps
NDIS_NET_TYPE_OFDM_2_4G 802.11g 2.4 Gigahertz
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 ULONG reference is populated with one of the parame-
ters listed above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetNetworkMode)(ULONG &);
#else
UINT GetNetworkMode(ULONG &);
#endif