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

Weitere Informationen

Bluetooth und getsockname

Bluetooth und BLOB

Bluetooth und WSASetService

WSAQUERYSET