BTListService (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTListService (Function)

In french: BTListeService

Returns the list of services provided by a Bluetooth device.

Example

nDeviceNumber is int
sListServices is string
sTmpString is string
// Clears the LIST_Services control
ListDeleteAll(LIST_Services)
// Returns the list of services for the selected device
IF TableSelect(TABLE_Devices) <> -1 THEN
// Device identifier
nDeviceNumber = TABLE_Devices.COL_ID[TABLE_Devices]
// Retrieve the list of services
sListServices = BTListService(nDeviceNumber)
// Add services into the list
FOR EACH STRING sTmpString OF sListServices SEPARATED BY CR
ListAdd(LIST_Services, sTmpString)
END
ELSE
Info("Select a Bluetooth device")
END

Syntax

<Result> = BTListService(<Device identifier> [, <Level of details> [, <Radio identifier>]])

<Result>: Character string

List of services supported by the device. This list has the following format:
in simple mode: <Name of Service 1> + CR + ... + CR + <Name of Service N>
in detailed mode: <Name of Service 1> + TAB + <Description of Service 1> + TAB + <Identifier of Service 1> + CR + ... + <Name of Service N> + TAB + <Description of Service N> + TAB + <Identifier of Service N>

<Device identifier>: Integer

Identifier of the Bluetooth device to use. This identifier is returned by the BTListDevice function or by the BTSelectDevice function.

<Level of details>: Optional Integer constant

Level of result details:
btDetailedList <Result> contains the list of services in detailed mode.
btSimpleList
(Default value) <Result> contains the list of services in simple mode.

<Radio identifier>: Optional integer

Identifier of Bluetooth radio to use. This identifier is returned by BTListRadio.
This parameter must not be specified. Indeed, a single Bluetooth radio is available on mobile devices.

Remarks

Only the Microsoft, Bluesoleil and Broadcom (Widcomm) bluetooth stacks are supported by this version. The Broadcom (Widcomm) stacks are not available in 64 bits.
Only the Microsoft bluetooth stacks are supported by this function. In most cases, the Broadcom stacks (Widcomm) are not supported (except for some rare cases).
To find out which battery is in use, use the BTStack function. See Which stacks to use? for more details

Component : wd260com.dll