User's Manual

Programming—Chapter 7
275700 Series Color Mobile Computer User’s Manual
Set Information Functions
AddWep()
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 Spec ifies the key i ndex to be set. Valid values are 0–3.
BOOL When set to TRUE, specifies that this key is the default transmit key.
TCHAR Pointer to a ch aracter array that specifies the key data in e ither HE X (length of
10 or 26) or ASCII (length of 5 or 13). This string must be null-terminated.
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 When adding WEP keys to the radio, turn off encryption before you add the keys, then turn en-
cryption back on afterw ards. 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 the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks Call this function with TRUE as th e parameter to enable WEP encryption. Call this function with
the F ALSE parameter to disable WEP encryption. This call is an alias for EncryptionStatus (). Se e
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