Funzione BluetoothSetLocalServiceInfo (bluetoothapis.h)

Articolo
03/14/2023

La funzione BluetoothSetLocalServiceInfo imposta le informazioni sul servizio locale per una radio Bluetooth specifica.

Sintassi

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

Parametri

[in, optional] hRadioIn

Handle del dispositivo radio Bluetooth per specificare le informazioni sul servizio locale per. Se NULL, BluetoothSetLocalServiceInfo cerca la prima radio Bluetooth locale disponibile.

[in] pClassGuid

GUID del servizio da esporre. Deve corrispondere al GUID nel file INF lato server.

[in] ulInstance

ID istanza per il nodo del dispositivo dell'ID Plug and Play (PnP).

[in] pServiceInfoIn

Puntatore a una struttura BLUETOOTH_LOCAL_SERVICE_INFO che descrive il servizio locale da impostare.

Valore restituito

La funzione BluetoothSetLocalServiceInfo restituisce i valori seguenti:

Codice restituito	Descrizione
ERROR_NOT_FOUND	La radio Bluetooth specificata non è stata rilevata.
ERROR_BAD_UNIT	Non sono state rilevate radio Bluetooth.
STATUS_INSUFFICIENT_RESOURCES	Risorse sufficienti non disponibili per completare l'operazione. È possibile ricevere questo errore quando più di 100 oggetti dispositivo fisico locale (PDO) corrispondono ai servizi Bluetooth.
STATUS_PRIVILEGE_NOT_HELD	Il chiamante non dispone dei privilegi necessari. Per informazioni su come elevare i privilegi, vedere la sezione Osservazioni.

Commenti

BluetoothSetLocalServiceInfo è un'API in modalità utente usata solo dagli sviluppatori di driver di profilo per attivare l'installazione di un servizio locale descritto dal GUID del servizio in pClassGuid.

BluetoothSetLocalServiceInfo genera un ID dispositivo Plug and Play (PnP) sotto forma di "BTHENUM{ClassGuid}". Ad esempio, "BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxx}". Le applicazioni in modalità utente possono chiamare i tempi successivi di BluetoothSetLocalServiceInfo con lo stesso GUID del servizio, ma con un ID istanza diverso per creare più istanze del profilo lato server specificato.

Per usare API Bluetooth come BluetoothSetLocalServiceInfo, le applicazioni in modalità utente devono essere collegate a BthProps.lib.

Avviso Il processo che chiama BluetoothSetLocalServiceInfo deve avere il privilegio di SE_LOAD_DRIVER_NAME . Un processo in esecuzione nel sistema o in un contesto di amministratore può elevare il proprio privilegio usando le funzioni SDK LookupPrivilegeValue e AdjustTokenPrivileges . Per altre informazioni su questo argomento, vedere Installazione di un dispositivo Bluetooth.

La struttura BLUETOOTH_LOCAL_SERVICE_INFO è definita nel file di intestazione BluetoothApis.h SDK.

Requisiti

Requisito	Valore
Client minimo supportato	Versioni:_Supported in Windows Vista e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	bluetoothapis.h
Libreria	BthProps.lib
DLL	bthprops.cpl; BluetoothAPIs.dll

Vedi anche

BLUETOOTH_LOCAL_SERVICE_INFO

Condividi tramite