Helper functions, Removewep(), Configureprofile() – Intermec 700 User Manual

Page 307

Advertising
background image

Programming

Chapter 7

283

700 Series Color Mobile Computer User’s Manual

RemoveWep()

Call this function with a key index of 0–3 to remove the WEP key at that
index.

Syntax

UINT RemoveWep( ULONG );

Parameters

ULONG value that specifies the key index to set. Valid values are 0–3.

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

On disassociation with all BSSIDs of the current service set, WEP key is removed by the adapter.

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_RemoveWEP)(ULONG);
#else
UINT RemoveWEP(ULONG);
#endif

Helper Functions

ConfigureProfile()

If using the Intermec 802.11 Profile Management system, you can pro-
gram the API to configure the radio to a specific profile by passing the
profile name.

Syntax

UINT ConfigureProfile( TCHAR * );

Parameters

Pointer to a character array that contains the profile name. This should 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

Call this function with a pointer to a null-terminated TCHAR array that contains the name of the
profile you wish to configure. This function reads profile data from the profile manager, sets that
profile as the default active profile, and configures the radio appropriately.
If needed, the supplicant and any other related services are automatically started and stopped.

Definitions

#ifdef DYNAMIC_LOADING
typedef UINT (*PFN_ConfigureProfile)(TCHAR *);
#else
UINT ConfigureProfile(TCHAR *);
#endif

Advertising