Funzione BluetoothEnumerateInstalledServices (bluetoothapis.h)

Articolo
02/26/2024

La funzione BluetoothEnumerateInstalledServices enumera i GUID dei servizi (Identificatori univoci globali) abilitati in un dispositivo Bluetooth.

Sintassi

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

Parametri

hRadio

Handle del dispositivo radio Bluetooth locale. Se NULL, tutte le radio locali vengono ricercate per i servizi abilitati che corrispondono all'indirizzo radio in pbtdi.

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO .

pcServiceInout

In input il numero di record a cui punta il parametro pGuidServices . Nell'output il numero di record validi restituiti nel parametro pGuidServices . Se pGuidServices è NULL, in output pcServices contiene il numero di servizi abilitati.

pGuidServices

Puntatore a un buffer in memoria per ricevere GUID per i servizi installati. Il buffer deve essere almeno *pcServices *sizeof(GUID) byte.

Valore restituito

Restituisce ERROR_SUCCESS al completamento corretto e il parametro pGuidServices contiene un elenco completo dei GUID del servizio abilitati.

La tabella seguente descrive un errore comune:

Codice restituito	Descrizione
ERROR_MORE_DATA	La chiamata ha avuto esito positivo. Il parametro pGuidServices contiene un elenco incompleto dei GUID del servizio abilitati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (includere Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl