Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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.

Note:
This function is actually a Winsock function. However, the information that is presented in it is specific to Bluetooth.

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 WSALookupServiceNextfunction 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_INQUIRYBLOBstructure.

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

Requirements

Header winsock2.h
Library Ws2.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also