Back to Sealevel      

int SME_SetWirelessConfig ( SME_HANDLE  handle,
int  network,
char *  SSID,
int  channel,
int  security,
int  keyType,
char *  key 
)

Configures a wireless enabled device's network settings.

Parameters:
[in] handle Valid handle returned by SME_Initialize().
[in] network Type of network connection
[in] SSID Network ID.
[in] channel Only valid for adhoc networks. Use zero otherwise.
[in] security Type of network security to enable
[in] keyType Type of key provided
[in] key Encryption key
Return values:
0 Success.
-1 Invalid SME_Initialize handle.
-2 No module selected. Call SME_SearchForModules() first.
-3 Invalid network parameter. See Network Types.
-4 Invalid SSID. SSID must be null-terminated and must not exceed 32 characters.
-5 Invalid channel number. Channel should be either zero (infrastructure), or between 1 and 14.
-6 Invalid security type. See Security Type.
-7 Invalid key type. See Key Type.
-8 Invalid key. Key must be null-terminated, contain at least one character, and must not exceed 64 characters.
-9 Invalid security type for adhoc. Use NONE or a WEP type encryption only.
-10 The supplied security configuration does not allow the use of hex keys (passphrase only).
-11 Invalid key. 64-bit hex keys require 10 characters; 128-bit hex keys require 26 characters.
-12 Hexidecimal key contains non-hexidecimal characters.
-13 Could not set device's wireless configuration due to network error.
-14 Invalid SSID parameter.
Configures a wireless device's network settings and configuration. Following a successful upload of the new wireless configuration, the wireless hardware will momentarily reboot and will therefore be unavailable on the network for several seconds.

Note:
Both of the SSID and key parameters must be null terminated strings.
Warning:
Setting the wireless configuration causes the module to reboot momentarily.
See also:
Network Types, Security Type, Key Type

 
 
Generated on 18 Sep 2007.