Click to Rate and Give Feedback
MSDN
MSDN Library
Windows Development
Wireless Networking
Bluetooth
Bluetooth Reference
Bluetooth Functions
 BluetoothEnumerateInstalledServices...
BluetoothEnumerateInstalledServices function

Applies to: desktop apps only

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

Syntax

DWORD BluetoothEnumerateInstalledServices(
  HANDLE hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD *pcServices,
  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.

pcServices

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 codeDescription
ERROR_MORE_DATA

The call succeeded. The pGuidServices parameter contains an incomplete list of enabled service GUIDs.

 

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2

Minimum supported server

None supported

Header

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

Library

Bthprops.lib

See also

BluetoothDisplayDeviceProperties
BluetoothFindFirstDevice
BluetoothFindNextDevice
BluetoothFindDeviceClose
BluetoothGetDeviceInfo
BluetoothRemoveDevice
BLUETOOTH_DEVICE_INFO
BLUETOOTH_DEVICE_SEARCH_PARAMS

 

 

Send comments about this topic to Microsoft

Build date: 2/3/2012

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2012 Microsoft. All rights reserved. Terms of Use | Trademarks | Privacy Statement
Page view tracker