BTInfoDevice (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.

Limitation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTInfoDevice (Function)

In french: BTInfoPériphérique

Returns specific information about a Bluetooth device.

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

<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.
btLastTimeSeen Date and time when the device was viewed for the last time by the current computer. This date is in DDMMYYYYHHMMSS format.
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.
btStatusRemembered
1 if the device is currently "remembered" by the Bluetooth device of the current computer,
0 otherwise.
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

Component: wd260com.dll