User's Manual

Chapter 7 — Programming
156 CN30 Mobile Computer User’s Manual
Basic Connect/Disconnect Functions
Below are functions available for the CN30 Mobile Computer when
enabled with the 802.1x radio module.
RadioConnect()
Connects to the available radio. Use this function if you plan on using a
lot of API calls that talk directly to the radio. Note that the 802.1x radio
must be enabled via NDISTRAY before you can connect to it.
Syntax UINT RadioConnect( );
Parameters None.
Return Values ERROR_SUCCESS when successful, otherwise
ERR_CONNECT_FAILED
Remarks Call this function before you call any other function found within
this API. It hunts out and connects to the 802.1x radio available on
the system. Check extended error codes if it returns anything else for
information.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_RadioConnect)();
#else
UINT RadioConnect();
#endif
RadioDisconnect()
Call this function when done using the 802.11 API to clean up a
connection from a previous RadioConnect() call. If you do not call this
function, you may leave memory allocated.
Syntax UINT RadioDisconnect( );
Parameters None.
Return Values ERROR_SUCCESS when successful, otherwise
ERR_CONNECT_FAILED.
Remarks None.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_RadioDisconnect)();
#else
UINT RadioDisconnect();
#endif
RadioDisassociate()
Call this function to have the 802.1x radio disassociate from the current
service set. The radio then enters an “off” mode until it is woken again by
setting the Service Set Identifier (SSID). Also, the NDIS driver generates
an NDIS media disconnect event.
Syntax UINT RadioDisassociate( );
Parameters None.
Return Values ERROR_SUCCESS when successful, otherwise
ERR_CONNECT_FAILED.
Remarks None.
Definitions #ifdef DYNAMIC_LOADING