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 |