BTInfoDevice (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Limitation
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTInfoDevice (Function)

In french: BTInfoPériphérique

Returns specific information about a Bluetooth device.

Versions 16 and later

This function is now available for Android applications.

Caution:

The Bluetooth functions are not available in the Android emulator.
The management of Bluetooth is available from Android 2.0.

New in version 16

This function is now available for Android applications.

Caution:

The Bluetooth functions are not available in the Android emulator.
The management of Bluetooth is available from Android 2.0.

This function is now available for Android applications.

Caution:

The Bluetooth functions are not available in the Android emulator.
The management of Bluetooth is available from Android 2.0.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Example

sListDevices is string
sADevice is string
sId is string
sName is string
sMACAddress is string
// Clears the list
TableDeleteAll(TABLE_Devices)
// Returns the list of nearby Bluetooth devices
sListDevices = BTListDevice(btSimpleList)
// Browse the connected devices
FOR EACH STRING sADevice OF sListDevices SEPARATED BY CR
// Stores the device information
sId = ExtractString(sADevice, 1)
sName = ExtractString(sADevice, 3)
sMACAddress = ExtractString(sADevice, 2)
// The name is explicitly requested if it is not specified
IF sName ~= "" THEN sName = BTInfoDevice(sId, btName)
// Fills the Table control with the devices
TableAddLine(TABLE_Devices, False, sId, sName, sMACAddress)
END

Syntax

<Result> = BTInfoDevice(<Device identifier> , <Requested information>)

<Result>: Character string

Requested information about the specified device.

<Device identifier>: Integer

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

<Requested information>: Integer constant

Information about the device. The table below lists the available information as well as the values that can be returned:
btMACAddress MAC address of the device
btClassOfDevice Class of the device, may correspond to one of the following constants:
btCoD_NetworkAccess
btCoD_AudioVideo
btCoD_Miscellaneous
btCoD_Imaging
btCoD_Unknown
btCoD_Toy
btCoD_Computer
btCoD_Device
btCoD_Phone
btCoD_Wearable
btLastTimeUsed Date and time when the device was used for the last time by the current computer. This date is in DDMMYYYYHHMMSS format.
This constant is not available.
btLastTimeSeen Date and time when the device was viewed for the last time by the current computer. This date is in DDMMYYYYHHMMSS format.
This constant is not available.
btStatusAuthenticated
1 if the device is currently authenticated beside the current computer,
0 otherwise.
btStatusConnected
1 if the device is currently "connected" to the current computer,
0 otherwise.
This constant is not available.
btStatusRemembered
1 if the device is currently "remembered" by the Bluetooth device of the current computer,
0 otherwise.
This constant is not available.
btName Device name

Remarks

Limitation

Only the Microsoft, Bluesoleil and Broadcom (Widcomm) bluetooth stacks are supported by this version. To find out the stack used, call BTStack.

The Broadcom (Widcomm) stacks are not available in 64 bits.

See Which stacks to use? for more details

Versions 16 and later

Required permissions

The call to this function modifies the permissions required by the application.

Required permission: BLUETOOTH.

This permission allows the applications to connect to the Bluetooth services.

New in version 16

Required permissions

The call to this function modifies the permissions required by the application.

Required permission: BLUETOOTH.

This permission allows the applications to connect to the Bluetooth services.

Required permissions

The call to this function modifies the permissions required by the application.

Required permission: BLUETOOTH.

This permission allows the applications to connect to the Bluetooth services.

Component : wd240com.dll