BluetoothGetDeviceInfo function

The BluetoothGetDeviceInfo function retrieves information about a remote Bluetooth device. The Bluetooth device must have been previously identified through a successful device inquiry function call.

Syntax


DWORD BluetoothGetDeviceInfo(
  HANDLE hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parameters

hRadio

A handle to a local radio, obtained from a call to the BluetoothFindFirstRadio or similar functions, or from a call to the SetupDiEnumerateDeviceInterfaces function.

pbtdi

A pointer to a BLUETOOTH_DEVICE_INFO structure into which data about the first Bluetooth device will be placed. For more information, see Remarks.

Return value

Returns ERROR_SUCCESS upon success, indicating that data about the remote Bluetooth device was retrieved. Returns error codes upon failure. The following table lists common error codes associated with the BluetoothGetDeviceInfo function.

Return codeDescription
ERROR_REVISION_MISMATCH

The size of the BLUETOOTH_DEVICE_INFO is not compatible. Check the dwSize member of the BLUETOOTH_DEVICE_INFO structure.

ERROR_NOT_FOUND

The radio is not known by the system, or the Address member of the BLUETOOTH_DEVICE_INFO structure is all zeros.

ERROR_INVALID_PARAMETER

The pbtdi parameter is NULL.

 

Remarks

The Bluetooth device for which data is obtained must have been previously identified through a successful device inquiry function call.

In the BLUETOOTH_DEVICE_INFO structure pointed to by pbtdi, the dwSize member must be equivalent to the size, in bytes, of the structure. The Address member of the BLUETOOTH_DEVICE_INFO structure must contain the Bluetooth address of the remote device.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

None supported

Header

BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)

Library

Bthprops.lib

DLL

Bthprops.dll

See also

BluetoothDisplayDeviceProperties
BluetoothFindFirstDevice
BluetoothFindNextDevice
BluetoothFindDeviceClose
BluetoothRemoveDevice
BLUETOOTH_DEVICE_INFO
BLUETOOTH_DEVICE_SEARCH_PARAMS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft