WSALookupServiceBegin (Bluetooth) (Windows CE 5.0)
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.
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 Values
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
OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.
Link Library: Ws2.lib.
See Also
Bluetooth Application Development Functions | BTHNS_INQUIRYBLOB | BTHNS_RESTRICTIONBLOB | WSALookupServiceEnd (Bluetooth) | WSALookupServiceNext (Bluetooth) | WSAQUERYSET (Bluetooth)
Send Feedback on this topic to the authors