struttura BTH_SET_SERVICE (ws2bth.h)

La struttura BTH_SET_SERVICE fornisce informazioni sul servizio per il servizio Bluetooth specificato.

Sintassi

typedef struct _BTH_SET_SERVICE {
  PULONG pSdpVersion;
  HANDLE *pRecordHandle;
  ULONG  fCodService;
  ULONG  Reserved[5];
  ULONG  ulRecordLength;
  UCHAR  pRecord[1];
} BTH_SET_SERVICE, *PBTH_SET_SERVICE, BTHNS_SETBLOB, *PBTHNS_SETBLOB;

Members

pSdpVersion

Versione del provider di servizi di configurazione. I client impostano questo membro su BTH_SDP_VERSION.

pRecordHandle

Handle per il record SDP. Corrisponde a SDP ServiceRecordHandle. Restituito dalle operazioni di aggiunta di record e successivamente utilizzato per eliminare il record.

fCodService

Classe di informazioni sul dispositivo (COD). Campo a 32 bit della classe COD_SERVICE_* di bit del dispositivo associati a questo record SDP. Il sistema combina questi bit con bit COD di altri record di servizio e caratteristiche di sistema. La classe risultante del dispositivo per la radio locale viene pubblicizzata quando la radio viene trovata durante la richiesta del dispositivo. Quando viene eliminato l'ultimo record SDP associato a un bit di servizio specifico, tale bit del servizio non viene più segnalato nelle risposte alle richieste future dei dispositivi.

Il formato e i valori possibili per il campo COD sono definiti nella parte Bluetooth Assigned Numbers 1.1 della specifica Bluetooth, Sezione 1.2. Questa risorsa potrebbe non essere disponibile in alcune lingue e paesi. Le macro e le definizioni corrispondenti per COD_SERVICE_* bit usati da Windows sono definite in Bthdef.h. Per altre informazioni sulla classe di dispositivo (COD), vedere BTH_DEVICE_INFO.

Reserved[5]

Riservato. Deve essere impostato su zero.

ulRecordLength

Dimensioni, in byte, di pRecord.

pRecord[1]

Record SDP, come definito dalla specifica Bluetooth.

Commenti

Quando si usa la struttura BTH_SET_SERVICE per eseguire query su servizi e dispositivi usando la funzione WSASetService e le strutture WSAQUERYSET e BLOB . È necessario utilizzare i valori seguenti per BTH_SET_SERVICE membri.

Per altre informazioni sulla classe di dispositivo (COD), vedere la specifica Bluetooth all'indirizzo www.bluetooth.com.

Membro	Valore richiesto
pSdpVersion	Puntatore alla versione di ULONG, che viene modificata ogni volta che cambia il formato binario dei record SDP, che influisce sul formato del membro pRecord . Impostare su BTH_SDP_VERSION per il client e restituito dal sistema.
pRecordHandle	Handle per il record SDP; corrisponde a SDP ServiceRecordHandle. Restituito dalle operazioni di aggiunta di record e successivamente utilizzato per eliminare il record.
fOptions	Attributi definiti da BTHNS_SET_FLAGS.
ulRecordLength	Lunghezza, in byte, del record SDP binario a cui punta pRecord.
pRecord	Puntatore a un record SDP valido, nel formato definito dalla specifica Bluetooth.

 

Il membro pRecordHandle deve puntare ai dati null per la registrazione del nuovo servizio. Per l'eliminazione del servizio, pRecordHandle deve puntare a un handle valido. Il membro pRecord deve contenere l'intero record del servizio SD, come descritto nella specifica Bluetooth. Per le voci del protocollo RFCOMM, il numero di porta corrisponde alla porta restituita dalla chiamata di funzione getsockname .

Bluetooth implementa una correlazione uno-a-uno tra i record SDP e i socket del server. Di conseguenza, non è necessario il flag SERVICE_MULTIPLE .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	ws2bth.h

Vedi anche

Bluetooth e getsockname

Bluetooth e BLOB

Bluetooth e WSASetService

WSAQUERYSET