|
◆ Connect() [3/3]
The method attempts to connect to a specific network.
- Parameters
-
IfaceId | The ID of the interface to use for the connection. |
Mode | A value that specifies the mode of connection. |
Profile | 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. |
Ssid | 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 . |
BssType | 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. |
Flags | The flags used to specify the connection parameters. |
BssList | The basic service set (BSS) identifiers (MACs) desired for the connection. |
- Returns
- If the function succeeds, the return value is wclCommon::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 CwclWiFiEvents component.
- See also
- wclWiFiConnectionMode, wclWiFiBssType, wclWiFiConnectFlags, wclWiFiBssList
|