Función BluetoothEnumerateInstalledServices (bluetoothapis.h)

Artículo
08/22/2023

La función BluetoothEnumerateInstalledServices enumera los GUID de servicios (identificadores únicos globales) habilitados en un dispositivo Bluetooth.

Sintaxis

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

Parámetros

hRadio

Identificador del dispositivo de radio Bluetooth local. Si es NULL, se buscan todos los radios locales en los servicios habilitados que coincidan con la dirección de radio en pbtdi.

pbtdi

Puntero a una estructura de BLUETOOTH_DEVICE_INFO .

pcServiceInout

En la entrada, el número de registros a los que apunta el parámetro pGuidServices . En la salida, el número de registros válidos devueltos en el parámetro pGuidServices . Si pGuidServices es NULL, en la salida pcServices contiene el número de servicios habilitados.

pGuidServices

Puntero a un búfer en memoria para recibir GUID para los servicios instalados. El búfer debe tener al menos bytes *pcServices *sizeof(GUID).

Valor devuelto

Devuelve ERROR_SUCCESS tras completarse correctamente y el parámetro pGuidServices contiene una lista completa de GUID de servicio habilitados.

En la tabla siguiente se describe un error común:

Código devuelto	Descripción
ERROR_MORE_DATA	La llamada se realizó correctamente. El parámetro pGuidServices contiene una lista incompleta de GUID de servicio habilitados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	bluetoothapis.h (incluya Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl