BluetoothEnumerateInstalledServices function (bluetoothapis.h)

The BluetoothEnumerateInstalledServices function enumerates the services GUIDs (Globally Unique Identifiers) enabled on a Bluetooth device.

Syntax

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

Parameters

hRadio

Handle of the local Bluetooth radio device. If NULL, all local radios are searched for enabled services that match the radio address in pbtdi.

pbtdi

Pointer to a BLUETOOTH_DEVICE_INFO structure.

pcServiceInout

On input, the number of records pointed to by the pGuidServices parameter. On output, the number of valid records returned in the pGuidServices parameter. If pGuidServices is NULL, on output pcServices contains the number of services enabled.

pGuidServices

Pointer to a buffer in memory to receive GUIDs for installed services. The buffer must be at least *pcServices *sizeof(GUID) bytes.

Return value

Returns ERROR_SUCCESS upon successful completion, and the pGuidServices parameter contains a complete list of enabled service GUIDs.

The following table describes a common error:

Return code	Description
ERROR_MORE_DATA	The call succeeded. The pGuidServices parameter contains an incomplete list of enabled service GUIDs.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
DLL	bthprops.cpl

See also

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothGetDeviceInfo

BluetoothRemoveDevice