BthNsLookupServiceBegin (Compact 2013)

3/26/2014

This function initiates a client query that is constrained by the information in a WSAQUERYSET structure.

Syntax

INT BthNsLookupServiceBegin(
  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 be performed. If this flag is not set, service discovery is performed instead.
  LUP_RES_SERVICE	Searches the local Service Discovery Protocol (SDP) database. Clear this flag to search for services on a peer device.

• lphLookup
  [out] Handle to use when calling the BthNsLookupServiceNext function to start retrieving the results set.

Return Value

The following table shows the possible return values.

Other standard HRESULT error codes may be returned as appropriate.

Remarks

This function returns a handle that the BthNsLookupServiceNext function uses.

Note   To preserve Win32 compatibility, consider using the Winsock equivalent of this function, WSALookupServiceBegin.

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

You can specify extra parameters for device inquiries by having the pQuerySet.lpBlob point to a BTHNS_INQUIRYBLOB structure.

If LUP_CONTAINERS is not set, an SDP service search is performed. The pQuerySet.lpBlob must point to a BTHNS_RESTRICTIONBLOB data structure.

Requirements

See Also

Reference

Bluetooth API Service Discovery Functions
BTHNS_INQUIRYBLOB
BTHNS_RESTRICTIONBLOB
BthNsLookupServiceEnd
BthNsLookupServiceNext
WSAQUERYSET (Bluetooth)