TwclRfCommClientConnection.Connect(Int64,TGUID,Byte,Boolean,Boolean,Cardinal) Method
Connects to a remote device.
public function Connect(const Address: Int64; const Service: TGUID; const Channel: Byte = 0; const Authentication: Boolean = True; const Encryption: Boolean = False; const Timeout: Cardinal = 10000): Integer;
Parameters
- Address
- Type: Int64
The remote Bluetooth device address.
- Service
- Type: TGUID
The Bluetooth Service UUID. If the
Channel
parameter is zero, the system attempts to useService
to resolve the remote channel corresponding to the service. The service class is a normalized 128-bit GUID, defined by the Bluetooth specification. Common GUIDs are defined by the Bluetooth Assigned Numbers document. Alternatively, a unique GUID may be used for a domain-specific application. - Channel
- Type: Byte
The RFCOMM channel number. If zero the
Service
UUID will be used. - Authentication
- Type: Boolean
Specifies that authentication is required for a connect operation to complete successfully. Setting this option actively initiates authentication during connection establishment, if the two Bluetooth devices were not previously authenticated.
- Encryption
- Type: Boolean
The option enforces encryption to establish a connection. Encryption is only available for authenticated connections.
- Timeout
- Type: Cardinal
The connect timeout in milliseconds. The default value is 10000 milliseconds.
Return Value
If the function succeed the return value is wclErrors.WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.
The method starts a connection operation to a remote
device. If the method success that does not mean that the connection
was established. That just means that the connection operation was
started. The real connection result will be passed to the
OnConnect
event handler.
NOTE: BlueSoleil does not support Authentication
and Encryption
parameters per connection.