Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Bluetooth and WSASetService

Bluetooth uses the WSASetService function to register or remove a service instance within the Bluetooth namespace (NS_BTH) from the registry. The handle returned by this operation may only be used to delete the service.

Bluetooth has two means of advertising services using the WSASetService function:

  • The application can have the system advertise a simple Bluetooth SDP service record, constructed from standard members in the WSAQUERYSET structure.
  • The application can have the system advertise their own Bluetooth SDP record by passing a BTH_SET_SERVICE structure in the lpBlob member of the WSAQUERYSET structure. This is a more complex approach.
Note  SDP records advertised by WSASetService do not persist after the process that published them has quit.
 

Use of WSASetService with Bluetooth has the following requirements:

  • The lpqsRegInfo parameter is the address of the WSAQUERYSET structure to be registered.
  • The essOperation parameter is an enumeration that contains one of the operations shown in the following table.
ValueDescription
RNRSERVICE_REGISTERStarts advertising the service to remote radios querying using the Bluetooth SDP protocol.
RNRSERVICE_DEREGISTERNot valid. Returns an error.
RNRSERVICE_DELETEStops advertising the service.

 

Note  Service handles discovered during a WSALookupServiceBegin or WSALookupServiceNext call are incompatible with the RNRSERVICE_DELETE operation.
 
  • The dwControlFlags parameter is reserved, and must be zero.

For more information and a list of Bluetooth socket options, see Bluetooth and Socket Options.

Related topics

Windows Sockets

 

 

Community Additions

Show:
© 2017 Microsoft