WSALookupServiceBegin (Bluetooth)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function initiates a client query that is constrained by the information contained within a WSAQUERYSET (Bluetooth) structure. This function returns a handle that is used by the WSALookupServiceNext (Bluetooth) function.

Syntax

INT WSALookupServiceBegin(
  LPWSAQUERYSET pQuerySet,
  DWORD dwFlags,
  LPHANDLE lphLookup
);

Parameters

• pQuerySet
  [in] Pointer to the search criteria.

• dwFlags
  [in] The following table shows a list of flags for this parameter.

  Flag	Description
  LUP_CONTAINERS	Specifies that device discovery is to be performed. If this flag is not set, service discovery will be performed instead.
  LUP_RES_SERVICE	Searches the local SDP database. Clear this flag to search for services on a peer device.

• lphLookup
  [out] Handle to be used when calling the WSALookupServiceNext (Bluetooth) function to start retrieving the results set.

Return Value

None.

Remarks

If LUP_CONTAINERS is set, SDP performs a device inquiry to find other Bluetooth devices in the area. This function performs the query. The WSALookupServiceNext function retrieves the results one device at a time.

You can specify extra parameters for device inquiries by having the lpsqRestriction->IpBlob point to a BTHNS_INQUIRYBLOB structure.

If LUP_CONTAINERS is not set, an SDP service search is performed. The lpsqRestrictions->IpBlob must point to a BTHNS_RESTRICTIONBLOB data structure.

Requirements

See Also

Reference

Bluetooth Application Development Functions
BTHNS_INQUIRYBLOB
BTHNS_RESTRICTIONBLOB
WSALookupServiceEnd (Bluetooth)
WSALookupServiceNext (Bluetooth)
WSAQUERYSET (Bluetooth)