User's Manual

Chapter 7 — Programming
CN30 Mobile Computer User’s Manual 159
Syntax UINT GetMac( TCHAR * );
Parameters Pointer to a character array, which is populated with the MAC address 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 formatted MAC
address of the 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.1x
radio.
Syntax UINT GetNetworkMode( ULONG & );
Parameters NDIS_NET_MODE_IBSS 802.1x Ad-Hoc Mode.
NDIS_NET_MODE_ESS 802.1x 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 5 Gigahertz 54Mbps
NDIS_NET_TYPE_OFDM_2_4G 802.1x 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 parameters
listed above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetNetworkMode)(ULONG &);
#else
UINT GetNetworkMode(ULONG &);
#endif
GetNetworkType()
Call this function to get the current network type of the radio. Do not
confuse this with GetNetworkMode().
Syntax UINT GetNetworkType( ULONG & );
Parameters NDIS_NET_TYPE_FH Indicates this is a frequency hopping radio.
NDIS_NET_TYPE_DS Indicates that this is a direct sequence radio.
NDIS_NET_TYPE_UNDEFINED Indicates this radio type is unknown or undefined.
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 parameters
listed above.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetNetworkType)(ULONG &);
#else