WSAQUERYSET (Bluetooth)

  • Article

This structure is a generic Winsock structure that other service search protocols can use for searching. The options discussed in this topic are specific to Bluetooth queries. For generic use of this structure, please refer to the WSAQUERYSET (Windows Sockets) structure for Winsock.

The following member descriptions indicate how the WSAQUERYSET structure is used to construct a query. If a member is optional, you can supply a NULL pointer, indicating that the member is not to be used for search criteria.

Members

  • dwNameSpace
    Value that must be set to NS_BTH for Bluetooth queries.
  • dwNumberOfCsAddrs
    Ignored for queries.
  • dwNumberOfProtocols
    Ignored.
  • dwOutputFlags
    Ignored for queries.
  • dwSize
    Value that is equal to sizeof(WSAQUERYSET). This is a versioning mechanism.
  • lpBlob
    This context varies depending upon the function. For a complete description of this value, see the BthNsLookupServiceBegin function or BthNsLookupServiceNext function.
  • lpcsaBuffer
    Ignored for service queries. When a name inquiry is performed and LUP_RETURN_ADDR is specified in the dwFlags parameter of the BthNsLookupServiceNext function, the Bluetooth address of a particular device will be returned in lpcsaBuffer>RemoteAddr.lpSockaddr.
  • lpNSProviderId
    Ignored.
  • lpServiceClassId
    Required. Identifies the services class in the form of a GUID.
  • lpszComment
    Ignored.
  • lpszContext
    Ignored.
  • lpszQueryString
    Ignored.
  • lpszServiceInstanceName
    When LUP_CONTAINERS is specified in the BthNsLookupServiceBegin function and LUP_RETURN_NAME is specified in the call to the BthNsLookupServiceNext function on this handle, the name of the particular device is returned in this member.
  • lpVersion
    Ignored.

Remarks

The following table shows how to use this structure for service queries.

Field Subfield Description
lpqsRestrictions dwNumber sizeof(WSAQUERYSET)
  lpServiceClassId Optional. The most specific Bluetooth UUID.
  dwNameSpace NS BTH
  dwNumberOfCsAddrs 1
  lpcsaBuffer If LUP_RES_SERVICE is not set, the RemoteAddr.lpSockaddr member specifies the Bluetooth address of the remote device to query.
  lpBlob If lpBlob is NULL, the UUID specified in the lpServiceClassId is used for an SDP service search. If lpBlob is not NULL, it points to a BTHNS_RESTRICTIONBLOB structure that contains more specific search parameters. In this case, lpServiceClassId is ignored.
  * All other WSAQUERYSET fields are ignored.
dwControlFlags LUP_CONTAINER Must not be set.
  LUP_RES_SERVICE Specifies to search only the local SDP database.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.

See Also

WSAQUERYSET (Windows Sockets) | BthNsLookupServiceBegin | BthNsLookupServiceNext | Bluetooth Structures

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.