ProgrammingChapter —7
272 700Series Color MobileComputer User’s Manual
GetMac()Call this function to get the MAC address of the 802.11b or 802.11b/g
radio.
Syntax UINT GetMac( TCHAR * );
Parameters Pointer to a character array, which is populated with the MAC address aftera s uccessful call.
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks If ERROR_SUCCESS is returned, your TCHAR array is populated with the formatted MAC
address ofth 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 Networ k Mode (SSID) for the
802.11b or 802.11b/g radio.
Syntax UINT GetNetworkMode( ULONG &);
Parameters NDIS_NET_MODE_IBSS 802.11 Ad-Hoc Mode.
NDIS_NET_MODE_ESS 802.11Infrastructure Mode.
NDIS_NET_MODE_UNKNOWN Anything Else/Unknown Error
NDIS_NET_AUTO_UNKNOWN Automatic Selection. Use of this option is not supportedor
recommended.
NDIS_NET_TYPE_OFDM_5G 5Gigahertz54Mbps
NDIS_NET_TYPE_OFDM_2_4G 802.11 2.4 Gigahertz
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks If ERROR_SUCCESS is returned, your ULONGrefere nce is populatedwith one of the parame-
terslisted above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetNetworkMode)(ULONG &);
#else
UINT GetNetworkMode(ULONG &);
#endif