Bluetooth Framework
ContentsIndexHome
PreviousUpNext
CwclRfCommServerConnection::Listen Method

The method starts listening for client connections.

Syntax
C++
int Listen(GUID Service, tstring ServiceName = _T(""), unsigned char Channel = 0, bool Authentication = true, bool Encryption = false);
Parameters 
Description 
GUID Service 
The Bluetooth Service UUID. If the Channel parameter is zero, the system attempts to use Service 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.  
tstring ServiceName = _T("") 
The option service name.  
unsigned char Channel = 0 
The RFCOMM channel number. If zero the Service UUID will be used.  
bool Authentication = true 
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.  
bool Encryption = false 
The option enforces encryption to establish a connection. Encryption is only available for authenticated connections.  

If the function succeed the return value is WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.

NOTE: BlueSoleil has limited support for Authentication and Encryption.. Also it doe snot support user-defined RFCOMM channel number.

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