Chapter 3 — Configuring the Computer

Set Information Functions

 

 

AddWep()

 

 

Call this function to add a WEP key to the radio. Call this function

 

 

multiple 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 encryption

 

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 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

751G Color Mobile Computer User’s Manual

87

Page 101
Image 101
Intermec 751G Set Information Functions, AddWep, EnableWep, Enables or disables WEP encryption on the radio TRUE/FALSE