Bluetooth and WSAQUERYSET for Device Inquiry
In Bluetooth, the WSAQUERYSET structure, is used to facilitate the discovery of devices and services in the Bluetooth namespace, NS_BTH.
The WSALookupServiceBegin and WSALookupServiceNext functions use the WSAQUERYSET structure to obtain information about the device inquiry process. The following table lists and describes member values in the WSAQUERYSET structure.
| Member | Input to WSALookupServiceBegin with LUP_CONTAINERS specified | Returned value from WSALookupServiceNext |
|---|---|---|
| dwSize | Must be set to sizeof(WSAQUERYSET). | sizeof(WSAQUERYSET) returned by system. |
| dwOutputFlags | Not used. | May have one or more of these flags set: BTHNS_RESULT_DEVICE_CONNECTED Specifies the device is connected. BTHNS_RESULT_DEVICE_REMEMBERED Specifies the device is a remembered device. Not all remembered devices are authenticated. BTHNS_RESULT_DEVICE_AUTHENTICATED Specifies the device is authenticated, paired, or bonded. All authenticated devices are remembered. |
| lpszServiceInstanceName | Not used. | Display name of the device, originally returned from a Bluetooth Remote Name Request operation, and possibly updated by the local user. Returned if LUP_RETURN_NAME is specified. |
| lpServiceClassId | Not used. | The 32-bit Bluetooth class of device (COD) field mapped to the Data1 member of the GUID. Returned if LUP_RETURN_TYPE is specified. |
| lpVersion | Not used. | Not used. |
| lpszComment | Not used. | Not used. |
| dwNameSpace | Must be NS_BTH. | Returns NS_BTH. |
| lpNSProviderId | Not used. | Not used. |
| lpszContext | Not used. | Not used. |
| dwNumberOfProtocols | Not used. | Not used. |
| lpafpProtocols | Not used. | Not used. |
| lpszQueryString | Not used. | Not used. |
| dwNumberOfCsAddrs | Not used. | Indicates the number of elements in the array of CSADDR_INFO structures. |
| lpcsaBuffer | Not used. | Pointer to a CSADDR_INFO structure with its LocalAddr.lpSockaddr member pointing to a SOCKADDR_BTH structure with the address of the remote device. Returned if LUP_RETURN_ADDR is specified. |
| lpBlob | Optional. May point to a BLOB structure that points to a BTH_QUERY_DEVICE structure that may limit the length of non-cached device inquiry operations. | Pointer to a BLOB structure that points to a BTH_DEVICE_INFO structure. lpBlob is returned if LUP_RETURN_BLOB is specified. Specify LUP_RETURN_NAME to retrieve the name field of BTH_DEVICE_INFO. |