WiFi Framework
ContentsIndexHome
PreviousUpNext
TwclWiFiClient.Connect Method

The method attempts to connect to a specific network.

Syntax
Pascal
function Connect(const IfaceId: TGUID; const Mode: TwclWiFiConnectionMode; const Profile: string; const Ssid: string; const BssType: TwclWiFiBssType; const Flags: TwclWiFiConnectFlags; const Bss: string = ''): Integer;
Parameters 
Description 
const IfaceId: TGUID 
The ID of the interface to use for the connection.  
const Mode: TwclWiFiConnectionMode 
A value that specifies the mode of connection.  
const Profile: string 
Specifies the profile being used for the connection.
If Mode is set to cmProfile, then Profile specifies the name of the profile used for the connection.
If Mode is set to cmTemporaryProfile, then Profile specifies the XML representation of the profile used for the connection.
If Mode is set to cmDiscoverySecure or cmDiscoveryUnsecure, then Profile should be set to an empty string.
 
const Ssid: string 
Specifies the SSID of the network to connect to. This parameter is optional. When set to and empty string, all SSIDs in the profile will be tried. This parameter must not be an empty string if Mode is set to cmDiscoverySecure or cmDiscoveryUnsecure.  
const BssType: TwclWiFiBssType 
Indicates the BSS type of the network. If a profile is provided, this BSS type must be the same as the one in the profile.  
const Flags: TwclWiFiConnectFlags 
The flags used to specify the connection parameters.  
const Bss: string = '' 
The basic service set (BSS) identifiers (MACs) desired for the connection.  

If the function succeeds, the return value is WCL_E_SUCCESS.  

If the function fails, the return value may be one of the WCL return codes.  

<

The Connect method returns immediately. To be notified when a connection is established or when no further connections will be attempted, a client must use the TwclWiFiEvents component.  

 

Copyright (c) 2006-2019. All rights reserved.