BTH_SET_SERVICE-Struktur (ws2bth.h)
Die BTH_SET_SERVICE-Struktur stellt Dienstinformationen für den angegebenen Bluetooth-Dienst bereit.
Syntax
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;
Member
pSdpVersion
Version der SDP. Clients legen dieses Element auf BTH_SDP_VERSION fest.
pRecordHandle
Handle für den SDP-Eintrag. Entspricht SDP ServiceRecordHandle. Wird von den Vorgängen zum Hinzufügen von Datensätzen zurückgegeben und anschließend zum Löschen des Datensatzes verwendet.
fCodService
Klasse von Geräteinformationen (COD). Ein 32-Bit-Feld mit COD_SERVICE_*-Klasse von Gerätebits, die diesem SDP-Eintrag zugeordnet sind. Das System kombiniert diese Bits mit COD-Bits aus anderen Dienstdatensätzen und Systemmerkmalen. Die resultierende Geräteklasse für das lokale Funkgerät wird angekündigt, wenn das Funkgerät während der Geräteuntersuchung gefunden wird. Wenn der letzte einem bestimmten Dienstbit zugeordnete SDP-Eintrag gelöscht wird, wird dieses Dienstbit nicht mehr in Antworten auf zukünftige Geräteanfragen gemeldet.
Das Format und die möglichen Werte für das COD-Feld sind im Teil Bluetooth Assigned Numbers 1.1 der Bluetooth-Spezifikation, Abschnitt 1.2, definiert. (Diese Ressource ist in einigen Sprachen und Ländern möglicherweise nicht verfügbar.) Entsprechende Makros und Definitionen für COD_SERVICE_*-Bits, die von Windows verwendet werden, werden in Bthdef.h definiert. Weitere Informationen zur Geräteklasse (Class of Device, COD) finden Sie unter BTH_DEVICE_INFO.
Reserved[5]
Reserviert. Muss auf 0 (null) festgelegt werden.
ulRecordLength
Größe von pRecord in Byte.
pRecord[1]
SDP-Eintrag, wie in der Bluetooth-Spezifikation definiert.
Hinweise
Wenn Sie die BTH_SET_SERVICE Struktur verwenden, um Dienste und Geräte mit der WSASetService-Funktion und WSAQUERYSET - und BLOB-Strukturen abzufragen. Die folgenden Werte für BTH_SET_SERVICE Member müssen verwendet werden.
Weitere Informationen zur Geräteklasse (Class of Device, COD) finden Sie in der Bluetooth-Spezifikation unter www.bluetooth.com.
| Mitglied | Erforderlicher Wert |
|---|---|
| pSdpVersion | Zeiger auf die ULONG-Version, die immer dann geändert wird, wenn sich das Binärformat von SDP-Datensätzen ändert, was sich auf das Format des pRecord-Elements auswirkt. Legen Sie für den Client auf BTH_SDP_VERSION fest, und wird vom System zurückgegeben. |
| pRecordHandle | Handle für den SDP-Eintrag; entspricht SDP ServiceRecordHandle. Wird von den Vorgängen zum Hinzufügen von Datensätzen zurückgegeben und anschließend zum Löschen des Datensatzes verwendet. |
| Foptions | Von BTHNS_SET_FLAGS definierte Attribute. |
| ulRecordLength | Länge des binären SDP-Eintrags in Bytes, auf den pRecord verweist. |
| pRecord | Zeiger auf einen gültigen SDP-Eintrag im format, das durch die Bluetooth-Spezifikation definiert ist. |
Das pRecordHandle-Element muss für die neue Dienstregistrierung auf Daten verweisen, die NULL sind. Beim Löschen des Diensts muss pRecordHandle auf ein gültiges Handle verweisen. Das pRecord-Element muss den gesamten SD-Dienstdatensatz enthalten, wie in der Bluetooth-Spezifikation beschrieben. Für RFCOMM-Protokolleinträge entspricht die Portnummer dem Port, der vom Aufruf der getockname-Funktion zurückgegeben wird.
Bluetooth implementiert eine 1:1-Korrelation zwischen SDP-Datensätzen und Serversockets. Daher ist das Flag "SERVICE_MULTIPLE " nicht erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | ws2bth.h |