Intermec 700 Series User Manual page 119

Network Support
ActivateRadioProfile()
This first reads all registry radio configuration information from the profile num-
ber specified. It then writes that data to the currently active section of the regis-
try for the wireless network. Finally, it updates the wireless network card and
activates the settings for the profile. Use the SetRegistryXXX commands to
modify one or more of radio profiles, then issue this command to activate a par-
ticular profile.
Syntax:
Parameters:
Return Value:
EncryptWEP_String()
This routine will take the unencrypted string passed in the second parameter
*szSourceBuffer and encrypt it in szDestinationBuffer for the 802.11b driver /
registry storage. Also, although the type is TCHAR, values other than printable
ASCII can be contained in the buffer passed into this routine. This allows the
use of hexadecimal keys to be encoded using this routine. If the length of the key
is not 13 or 5 characters, the function will return a non-zero error code. If the
encryption is successful, then NULL will be returned. The enable_flag is
encoded into the WEP key. It is typically set to 1 so that the resulting WEP key
will be active when written to the registry. If enable_flag is zero, then the string
will be encoded, but within the encoded string there will be a bit that specifies
that the encrypted string is not enabled.
" NOTE:
This routine is for encrypting a string and does not effect the registry or the wireless network
card. The routine is provided if you wish to encrypt and store keys within a program.
Syntax:
Parameters:
4-42 700 Series Color Mobile Computer User's Manual
int ActivateRadioProfile( int ProfileNumber );
ProfileNumber [in] This is an integer value that specifies which
configuration number the user wants to activate. Valid
values are CONFIG_01, CONFIG_02, and CONFIG_03.
This function returns a NULL if successful or a non-zero value if an error
occurs.
int EncryptWEP_String( TCHAR *szDestinationBuffer, TCHAR
*szSourceBuffer, BOOL enable_flag );
*szDestinationBuffer
*szSourceBuffer
enable_flag
[out] Pointer to the buffer where the encrypted key
will be stored. The size of the buffer needs to be
128 chars (128 * (sizeof(TCHAR))).
[in] Character buffer for unencrypted WEP key.
There must be either 5 or 13 chars in the WEP key
and the string needs to be null terminated.
[in] This is a boolean value that is encrypted into
the WEP string. It will typically be set to one, so
that the resulting encrypted key will be active. If
set to zero, the key can still be stored in the
registry, but it will not be used by the driver.
SECTION 4