AddLocalService Method

Adds a local service.

Syntax

• C++

ANSI (Cross Platform)
int AddLocalService();

Unicode (Windows)
INT AddLocalService();

#define MID_BTINFO_ADDLOCALSERVICE 2

IPWORKSBT_EXTERNAL int IPWORKSBT_CALL IPWorksBT_BTInfo_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method adds a service that may then be discovered by other devices.

When adding a service a BTDaemon instance (or other Bluetooth application) should already be listening for incoming connections. To specify service details first set ServiceCount to 1 and select the service by setting ServiceIndex to 0. With the service selected specify additional properties. The following properties are applicable when adding a service:

• ServiceAddress (required)
• ServiceClassId (required)
• ServicePort (required)
• ServiceProtocol (required)
• ServiceName (required)
• ServiceComment

For example:

btinfo.ServiceCount = 1;
btinfo.ServiceIndex = 0;
btinfo.ServiceComment = "test";
btinfo.ServiceAddress = "00:02:72:C6:64:B7";
btinfo.ServiceName = "EchoServer";
btinfo.ServiceClassId = "00001101-0000-1000-8000-00805f9b34fb";
btinfo.ServicePort = 10;
btinfo.ServiceProtocol = "RFCOMM";
btinfo.AddLocalService();

To remove a service call RemoveLocalService. Find existing services by calling ListServices.

Note: The service will automatically be removed by the system when the process which registered the service exits.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)