Query information functions, Radiodisassociate(), Getassociationstatus() – Intermec 700 User Manual

Page 293

Advertising
background image

Programming

Chapter 7

269

700 Series Color Mobile Computer User’s Manual

RadioDisassociate()

Call this function to have the 802.11b or 802.11b/g 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
typedef UINT (*PFN_RadioDisassociate)();
#else
UINT RadioDisassociate();
#endif

Query Information Functions

GetAssociationStatus()

Call this function to obtain the radio’s current association status with a
service set.

Syntax

UINT GetAssociationStatus( ULONG & );

Parameters

NDIS_RADIO_ASSOCIATED

Indicates the radio is associated with an access point

NDIS_RADIO_SCANNING

Indicates the radio is looking for an access point with which
to associate

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 the function returns ERROR_SUCCESS. Also, if ERROR_SUCCESS is re-
turned, your ULONG reference is populated by one of the parameters listed above.

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_GetAssociationStatus)(ULONG &);
#else
UINT GetAssociationStatus(ULONG &);
#endif

Advertising