.associate Method
Function: |
Causes the Wi-Fi interface to attempt association with the specified wireless network. This method is a task. |
Syntax: |
wln.associate(byref bssid as string, byref ssid as string, channel as byte, bssmode as pl_wln_bss_modes) as accepted_rejected |
Returns: |
One of accepted_rejected constants: 0 — ACCEPTED. 1 — REJECTED. |
See Also: |
Associating With a Network, wln.disassociate, wln.associationstate |
Parameter |
Description |
bssid |
GA1000: This argument must contain the actual BSSID ("MAC address") of the target network. WA2000: Provide the BSSID of the target network or set this argument to "" or "0.0.0.0.0.0" to allow the wln. object associate with any network with matching SSID. |
ssid |
The name of the target network with which to associate. |
channel |
GA1000: This argument must contain the correct channel on which the target network operates. WA2000: Provide the correct channel or set this argument to 0 to allow the wln. object associate with the target network on any channel. |
bssmode |
Network mode of the target network: 0 — PL_WLN_BSS_MODE_INFRASTRUCTURE. 1 — PL_WLN_BSS_MODE_ADHOC. GA1000 can associate with infrastructure and ad-hoc networks. WA2000 can only associate with infrastructure networks. For it, this argument should always be set to 0- PL_WLN_BSS_MODE_INFRASTRUCTURE. |