BTInfoDevice (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

Bluetooth

WLanguage functions

WLanguage procedure

BTInfoDevice

Presentation

Example

Limitation

Required permissions

See also

BTInfoDevice (Function)

In french: BTInfoPériphérique

Returns specific information about a Bluetooth device.

Caution: Bluetooth functions are not available in the Android emulator.

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 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:
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
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.
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.
btMACAddress MAC address of the device
btName Device name
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.

Remarks

Limitation

This version only supports Microsoft, Bluesoleil and Broadcom (Widcomm) bluetooth stacks. To know the stack used, call BTStack.

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

For more details, see Which stacks to use?

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: wd270com.dll