Intermec 700 Series User Manual page 120

SECTION 4
" NOTE:
If you examine the encrypted string output by this function, you will notice that the tenth posi-
tion in the string will be affected by the state of this bit. An 'E' will be in the tenth position if
enable_flag is 1 and a '5' will be in the tenth position if the enable_flag is 0.
Return Value:
GetNIC_NetworkConnectState()
This returns the name (SSID) of the network to which the unit is connected. If
the unit is currently not connected to any network, the string returned will be
empty.
Syntax:
Parameters:
Return Value:
GetNIC_SignalStrength()
This routine allows reading real-time signal quality statistics from the 802.11b
NIC. This feature permits the application to sense when the radio is out of range
of a base station and take appropriate action.
Syntax:
Parameters:
Return Value:
The function will return a zero if the WEP encryption was successful. It
will return a non-zero error code if not.
int GetNIC_NetworkConnectState( TCHAR *SSIDstr );
*SSIDstr [out] This is a pointer to the string that will hold the network
name (SSID). The string should be a minimum of 33
characters in length.
This function returns a NULL if successful or a non-zero value if an error
occurs.
int GetNIC_SignalStrength( int *SignalLevel, int *NoiseLevel, int
*SignalQuality, int *indicator );
*SignalLevel [out] Gives the level of the RF signal in dBm.
*NoiseLevel [out] Gives the RF noise level in dBm.
*SignalQuality [out] Signal to Noise Radio of the signal in dB.
*indicator [out] Quality indicator.
This value gives the programmer a four level indication
of the signal level. This indicator saves the API
programmer from having to calculate the signal quality.
The values are based off of the SignalLevel value.
3 = Excellent
2 = Good
1 = Poor
0 = Out of range (< –100 dBm)
This function returns a NULL if successful or a non-zero value if an error
occurs.
(0 to –70 dBm)
(–85 to –71 dBm)
(–100 to –86 dBm)
700 Series Color Mobile Computer User's Manual
Network Support
4-43