Freigeben über


Bluetooth und WSAQUERYSET für Dienstanfrage

Bluetooth verwendet die WSAQUERYSET--Struktur mit verschiedenen Funktionen, um die Ermittlung von Geräten und Diensten im Bluetooth-Namespace NS_BTH zu erleichtern.

Die WSALookupServiceBegin und WSALookupServiceNext Funktionen verwenden die WSAQUERYSET- Struktur, um Daten über den Dienstanfrageprozess abzurufen. In der folgenden Tabelle wird beschrieben, wie die Memberwerte in der WSAQUERYSET- Struktur zu diesem Zweck festgelegt werden.

Mitglied Eingabe für WSALookupServiceBegin Zurückgegebener Wert von WSALookupServiceNext
dwSize- Muss auf Größefestgelegt werden (WSAQUERYSET). Größe der vom System zurückgegebenen(WSAQUERYSET).
dwOutputFlags Wird nicht verwendet. Wird nicht verwendet.
lpszServiceInstanceName Wird nicht verwendet. Anzeigename des Diensts, konvertiert als UTF-8-codierte Zeichenfolge aus der Standardsprachencodierung des Bluetooth ServiceName SDP-Attributs. Wird zurückgegeben, wenn LUP_RETURN_NAME angegeben ist.
lpServiceClassId- Erforderlich. Die spezifischste Bluetooth UUID für die Dienste, für die die Suche durchgeführt wird. Wenn dieser Wert beispielsweise auf die UUID des L2CAP-Protokolls festgelegt ist, gibt er alle Dienste zurück, die das L2CAP-Protokoll auf dem Zielgerät verwenden. Wenn sie auf die UUID eines bestimmten Diensts festgelegt ist, würde sie nur die Instanzen dieses Diensts zurückgeben. Wird nicht verwendet.
lpVersion- Wird nicht verwendet. Wird nicht verwendet.
lpszComment Wird nicht verwendet. Beschreibung des Diensts, konvertiert als UTF-8-codierte Zeichenfolge aus der Standardsprachencodierung des Bluetooth ServiceDescription SDP-Attributs. Wird zurückgegeben, wenn LUP_RETURN_COMMENT angegeben ist.
dwNameSpace- Muss NS_BTH sein. Gibt NS_BTH zurück.
lpNSProviderId- Wird nicht verwendet. Wird nicht verwendet.
lpszContext Erforderlich. Die Bluetooth-Geräteadresse, mit der eine SDP-Verbindung hergestellt und Dienste abgerufen werden sollen. Dieser Wert muss eine Zeichenfolge sein, die mithilfe des WSAAddressToString- Funktionsaufrufs konvertiert wurde. Wenn die lokale Bluetooth-Geräteadresse angegeben wird, wird die lokale SDP-Datenbank durchsucht. Wird nicht verwendet.
dwNumberOfProtocols Wird nicht verwendet. Wird nicht verwendet.
lpafpProtocols Wird nicht verwendet. Wird nicht verwendet.
lpszQueryString- Wird nicht verwendet. Wird nicht verwendet.
dwNumberOfCsAddrs Wird nicht verwendet. Gibt die Anzahl der Elemente im Array CSADDR_INFO Strukturen an.
lpcsaBuffer Wird nicht verwendet. Zeiger auf eine CSADDR_INFO Struktur, deren LocalAddr.lpSockaddr Member auf eine SOCKADDR_BTH zeigt, die die vollständige verbindungsfähige Adresse des Remotediensts enthält, die aus dem ersten Eintrag des Bluetooth ProtocolDescriptorList-SDP-Attributs konvertiert wurde. Wird zurückgegeben, wenn LUP_RETURN_ADDR angegeben ist.
lpBlob Wahlfrei. Zeigen Sie auf eine BTH_QUERY_SERVICE Struktur, die erweiterte Parameter enthält, um die Ergebnisse der Suche einzuschränken. Wenn angegeben, wird lpServiceClassId ignoriert, und zwischengespeicherte Abfragen werden nicht erfolgreich ausgeführt.
  • Wenn eine Dienstsuche ausgeführt wird: Zeiger auf eine BLOB- Struktur, die die Diensthandles zurückgibt. (BLOB.cbSize)/Sizeof(ULONG) berechnet die Anzahl der Ziehpunkte. BLOB.pBlobData- ist ein Array von ULONG-Werten, die die Diensthandles darstellen.
  • Wenn eine Attribut- oder ServiceAttribute-Suche ausgeführt wird: Zeiger auf eine BLOB- Struktur, die den binären SDP-Eintrag zurückgibt. BLOB.cbSize ist die Größe des binären SDP-Eintrags. BLOB.pBlobData verweist auf den Datensatz selbst. Der binäre SDP-Eintrag ist in vielen Fällen erforderlich, da nur eine begrenzte Anzahl von SDP-Attributen in die WSAQUERYSET--Struktur konvertiert werden kann und nur standardmäßig codierte UTF-8-Zeichenfolgen konvertiert werden. Funktionen zur Unterstützung der Analyse des binären SDP-Eintrags werden im Abschnitt Bluetooth Reference bereitgestellt.
  • Wird zurückgegeben, wenn LUP_RETURN_BLOB angegeben ist.

 

Bluetooth und WSAQUERYSET für set Service-

Bluetooth und WSAQUERYSET für Geräteanfrage

Bluetooth- und BLOB-

Bluetooth- und WSALookupServiceBegin-

Bluetooth und WSALookupServiceNext

Bluetooth-Referenz-

BLOB-

BTH_QUERY_SERVICE

CSADDR_INFO

SOCKADDR_BTH

WSAAddressToString-

WSAQUERYSET-

Windows Sockets