Set information functions, Addwep(), Enablewep() – Intermec 700 User Manual
Page 302
Programming
Chapter
—
7
278
700 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-
ple times when adding more than one WEP key. Save the “default” key for
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: Add the default transmit key last.
Syntax
UINT AddWep( ULONG, BOOL, TCHAR * );
Parameters
ULONG
Specifies the key index 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 character array that specifies the key data in either HEX (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 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 the query failed, or
ERR_CONNECT_FAILED if a connection with the radio failed.
Remarks
Call this function with TRUE as the parameter to enable WEP encryption. Call this function with
the FALSE parameter to disable 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