BTListService (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

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 BTListDevice or by BTSelectDevice.

<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 for the mobile devices.

Remarks

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 the stack used, call BTStack. See Which stacks to use? for more details

Component : wd250com.dll