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 |
|---|---|
|
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_SEARCH_PARAMS