BluetoothSetLocalServiceInfo function

Article
10/06/2015

The BluetoothSetLocalServiceInfo function sets local service information for a specific Bluetooth radio. This function is used to advertise services to which remote devices can connect.

Note Service information set with this function will persist across reboots.

Syntax

DWORD WINAPI BluetoothSetLocalServiceInfo(
  _In_opt_       HANDLE                       hRadioIn,
  _In_     const GUID                         *pClassGuid,
                 ULONG                        ulInstance,
           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

Parameters

hRadioIn [in, optional]
A handle of the Bluetooth radio device to which the local service information applies. If this parameter is NULL, BluetoothSetLocalServiceInfo searches for the first available local Bluetooth radio.
pClassGuid [in]
The GUID of the service to expose. This should match the GUID in the server-side INF file for the profile driver.
ulInstance
An instance ID for the device node of the Plug and Play (PnP) ID.
pServiceInfoIn
A pointer to a BLUETOOTH_LOCAL_SERVICE_INFO structure that describes the local service to set.

Return value

Returns ERROR_SUCCESS upon successful completion. The following table shows some common errors.

Return code	Description
ERROR_NOT_FOUND	The specified Bluetooth radio was not detected.
ERROR_BAD_UNIT	No Bluetooth radios were detected.
STATUS_INSUFFICIENT_RESOURCES	There were insufficient resources to complete the operation. This condition occurs when more than 100 local physical device objects (PDOs) corresponding to Bluetooth services.
STATUS_PRIVILEGE_NOT_HELD	The caller does not have the required privileges.

Remarks

Applications can call BluetoothSetLocalServiceInfo subsequent times with the same service GUID but with a different instance ID to create multiple instances of the specified server-side profile. It is important that each instance ID associated with a device is unique, as it will prevent the service driver from being prematurely uninstalled if one, of possibly many, dependent devices is unpaired.

The process that calls BluetoothSetLocalServiceInfo must have the SE_LOAD_DRIVER_NAME privilege. A process running in the system or in the administrator context can elevate its privilege using the LookupPrivilegeValue and AdjustTokenPrivileges functions.

Requirements

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	None supported
Header	BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)
Library	Bthprops.lib
DLL	Bthprops.dll

Share via