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.

Help / WLanguage / WLanguage functions / Communication / Bluetooth

Limitation
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

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

sListePeriphériques is string
sUnPeripherique is string
sId is string
sNom is string
sAdresseMAC is string
// Vide la liste
TableDeleteAll(TABLE_Periphériques)
// Liste les périphériques Bluetooth à proximité
sListePeriphériques = BTListDevice(btSimpleList)
// Parcours des périphériques connectés
FOR EACH STRING sUnPeripherique OF sListePeriphériques SEPARATED BY CR
	// Mémorise les informations du périphérique
	sId = ExtractString(sUnPeripherique, 1)
	sNom = ExtractString(sUnPeripherique, 3)
	sAdresseMAC = ExtractString(sUnPeripherique, 2)
	// Si le nom n'est pas renseigné, demande le nom explicitement
	IF sNom ~= "" THEN sNom = BTInfoDevice(sId, btName) 
	// Remplit le champ Table avec les périphériques
	TableAddLine(TABLE_Periphériques, False, sId, sNom, sAdresseMAC)
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.

Broadcom (Widcomm) stacks are not available in 64-bit mode.

For more details, see Which stacks to use?

Required permissions

This function changes the permissions required by the application.

Permission required: BLUETOOTH.

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

Component: wd300com.dll