Bluetooth und WSALookupServiceBegin für Geräteabfragen
In diesem Thema wird beschrieben, wie Sie die WSALookupServiceBegin-Funktion verwenden, um eine Untersuchung von sichtbaren und ge ghosteten Geräten durchzuführen. Weitere Informationen finden Sie unter Ermitteln von Bluetooth-Geräten und -Diensten.
Die WSALookupServiceBegin-Funktion verwendet eine WSAQUERYSET-Struktur im ersten Parameter lpqsRestrictions, um Suchkriterien zu definieren. Bluetooth bietet spezifische Richtlinien für die Verwendung der WSALookupServiceBegin-Funktion und WSAQUERYSET.
In der folgenden Tabelle sind Einschränkungen aufgeführt, die für die WSAQUERYSET-Struktur gelten, die beim Abfragen von Geräten an den lpqsRestrictions-Parameter übergeben wird.
| WSAQUERYSET-Member | Einschränkung |
|---|---|
| dwSize | Legen Sie auf sizeof(WSAQUERYSET) fest. |
| lpBlob | Dieses Element enthält einen optionalen Zeiger auf eine BLOB-Struktur . Wenn dieser Member angegeben ist, sind die gültigen Geräte-Abfrageparameter für LUP_FLUSHCACHE wie folgt:
|
| dwNameSpace | Auf NS_BTH festgelegt. |
| Andere Mitglieder | Andere Member der WSAQUERYSET-Struktur werden ignoriert. |
Die in der folgenden Tabelle aufgeführten Flags werden im dwControlFlags-Parameter verwendet, um die Abfrageergebnisse zu steuern. Die flags LUP_CONTAINERS und LUP_FLUSHCACHE werden von der WSALookupServiceBegin-Funktion verwendet. die restlichen Flags werden in Aufrufen der WSALookupServiceNext-Funktion verwendet.
| Flag | Ergebnis |
|---|---|
| LUP_CONTAINERS | Gibt an, dass der Abfragezweck darin besteht, eine Liste von Bluetooth-Geräten und nicht eine Liste von Diensten abzurufen. Dieses Flag muss festgelegt werden. |
| LUP_FLUSHCACHE | Löst eine Abfrage lokaler Geräte aus oder bewirkt, dass zwischengespeicherte Ergebnisse aus vorherigen Abfragen zurückgegeben werden. |
| LUP_RETURN_TYPE | Gibt den Bluetooth-COD (Klasse der Gerätebits) direkt im lpServiceClassId-Member der WSAQUERYSET-Struktur zurück. Der COD wird dem Data1-Member der GUID zugeordnet. |
| LUP_RES_SERVICE | Gibt Informationen für die lokale Bluetooth-Adresse zurück. Dieses Flag wirkt sich nur aus, wenn auch LUP_RETURN_ADDR angegeben ist. |
| LUP_RETURN_NAME | Gibt den Anzeigenamen des Geräts im lpszServiceInstanceName-Member der WSAQUERYSET-Struktur für jeden Aufruf der WSALookupServiceNext-Funktion zurück. Dieses Flag muss auch angegeben werden, um den Namensmember der BTH_DEVICE_INFO-Struktur abzurufen, wenn das flag LUP_RETURN_BLOB angegeben wird. |
| LUP_RETURN_ADDR | Gibt eine SOCKADDR_BTH-Struktur zurück, die die 48-Bit-Adresse des Peers im lpcsaBuffer-Member der WSAQUERYSET-Struktur für jeden Aufruf der WSALookupServiceNext-Funktion enthält. Andere Member in der SOCKADDR_BTH-Struktur sind leer. |
| LUP_RETURN_BLOB | Gibt die BTH_DEVICE_INFO-Struktur bei jedem nachfolgenden Aufruf von WSALookupServiceNext zurück. |
| LUP_FLUSHPREVIOUS | Überspringen Sie das nächste verfügbare Gerät, und geben Sie das darauf folgende Gerät zurück. |
Zugehörige Themen