.Associate Method

Top Previous Next

Function:	Causes the Wi-Fi interface to commence association with the wireless network specified by the wln.ssid property.
Syntax:	wln.associate() as accepted_rejected
Returns:	One of accepted_rejected constants: 0- ACCEPTED. 1- REJECTED.
See Also:	Associating With Selected Network, Setting WEP Mode and Keys, Wln Tasks

Details

Prior to performing an association attempt, the application must preset the following: WEP mode and keys if required (see wln.wepmode, wln.wepkey1... wln.wepkey4, and wln.setwep), desired network mode (wln.bssmode), network name (wln.ssid), and default channel (wln.defaultibsschannel) in case of ad-hoc network mode . For more information see the Associating With Selected Network topic.

The association process is a task. As such, the wln.associate will be rejected (return 1- REJECTED) if another task is currently in progress. The task will also be rejected if the Wi-Fi interface is already in the associated state (wln.associationstate= 1- PL_WLN_ASSOCIATED), or if the Wi-Fi hardware is not online (wln.enabled= 0- NO). The method will return 0- ACCEPTED if the task is accepted for processing.

The task is completed when the wln.task R/O property becomes 0- PL_WLN_TASK_IDLE. The on_wln_task_complete event will also be generated at that time.

Task completion does not imply success -- association result has to be verified by reading the state of tthe wln.associationstate read-only property after the task is completed.