ProgrammingChapter —7
278 700Series Color MobileComputer User’s Manual
Set Information FunctionsAddWep()
Call this function to add a WEP key to the radio. Call this function multi-
pletimeswhenaddingmorethanoneWEPkey.Savethe“default”keyfor
last. For example,when adding four keys, and the second key is the default
transmit key, add keys 1, 3 and 4 before you add key 2.
Note: Addthedefaulttransmitkeylast.
Syntax UINT AddWep( ULONG, BOOL, TCHAR * );
Parameters ULONG Specifies the key index to be set. Valid values are 0–3.
BOOL Whenset to TRUE, specifies that this key is the default transmit key.
TCHAR Pointerto a character array that specifies th e keydata in eithe r HEX (length of
10 or 26) or ASCII (length of 5 or 13). This string mu st be null-terminated.
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks When adding WEP keys to the radio, tur n off encryption before you add the keys, then t urn en-
cryptionback on afterwards. Also, be sure to add the TRANSMIT KEY last.
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_AddWep)(ULONG, BOOL, TCHAR *);
#else
UINT AddWep(ULONG, BOOL, TCHAR *);
#endif
EnableWep()
Enables or disables WEP encryption on the radio (TRUE/FALSE).
Syntax UINT EnableWep( BOOL );
Parameters Set BOOL to TRUE to enable WEP encryption, or FALSE to disable WEP encryption.
Return Values ERROR_SUCCESS when successful, ERR_QUERY_FAILED when th e query failed, or
ERR_CONNECT_FAILED if a connection with t he radio failed.
Remarks Callthis fu nctionwith TRUE as the parameter to enable WEP encryption. Call this function with
the FALSE parameter todisable WEP encryption. This call is an alias for EncryptionStatus(). See
the following:
EnableWEP(TRUE) = EncryptionStatus(NDIS_ENCRYPTION_1_ENABLED)
EnableWEP(FALSE) = EncryptionStatus(NDIS_ENCRYPTION_DISABLED)
Definitions #ifdef DYNAMIC_LOADING
typedef UINT (*PFN_EnableWep)(BOOL);
#else
UINT EnableWep(BOOL);
#endif