Funzione BluetoothSetServiceState (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothSetServiceState abilita o disabilita i servizi per un dispositivo Bluetooth.

Sintassi

DWORD BluetoothSetServiceState(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  const GUID                  *pGuidService,
  DWORD                       dwServiceFlags
);

Parametri

hRadio

Handle della radio Bluetooth locale.

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO . Deve essere un indirizzo radio trovato in precedenza.

pGuidService

Puntatore al GUID del servizio nel dispositivo remoto.

dwServiceFlags

Flag che regolano il servizio. Per disabilitare il servizio, impostare su BLUETOOTH_SERVICE_DISABLE; per abilitare il servizio, impostare su BLUETOOTH_SERVICE_ENABLE.

Valore restituito

Restituisce ERROR_SUCCESS al completamento corretto. La tabella seguente elenca gli errori comuni.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	I dwServiceFlags non sono validi.
ERROR_SERVICE_DOES_NOT_EXIST	Il GUID specificato in pGuidService non è supportato.
E_INVALIDARG	dwServiceFlags è impostato su BLUETOOTH_SERVICE_DISABLE e il servizio è già disabilitato oppure dwServiceFlags è impostato su BLUETOOTH_SERVICE_ENABLE e il servizio è già abilitato.

Commenti

Windows gestisce un mapping dei servizi Identificatori univoci globali (GUID) ai driver supportati per i dispositivi abilitati per Bluetooth. L'abilitazione di un servizio installa il driver di dispositivo corrispondente e disabilita un servizio rimuove il driver di dispositivo corrispondente. Se un servizio non supportato è abilitato, non è installato un driver.

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