Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The BluetoothSetServiceState function enables or disables services for a Bluetooth device.
Syntax
DWORD BluetoothSetServiceState(
HANDLE hRadio,
const BLUETOOTH_DEVICE_INFO *pbtdi,
const GUID *pGuidService,
DWORD dwServiceFlags
);
Parameters
hRadio
A handle of the local Bluetooth radio.
pbtdi
A pointer to a BLUETOOTH_DEVICE_INFO structure. Must be a previously found radio address.
pGuidService
A pointer to the service GUID on the remote device.
dwServiceFlags
The flags that adjust the service. To disable the service, set to BLUETOOTH_SERVICE_DISABLE; to enable the service, set to BLUETOOTH_SERVICE_ENABLE.
Return value
Returns ERROR_SUCCESS upon successful completion. The following table lists common errors.
| Return code | Description |
|---|---|
|
The dwServiceFlags are not valid. |
|
The GUID specified in pGuidService is not supported. |
|
dwServiceFlags is set to BLUETOOTH_SERVICE_DISABLE and the service is already disabled, or dwServiceFlags is set to BLUETOOTH_SERVICE_ENABLE and the service is already enabled. |
Remarks
Windows maintains a mapping of service Globally Unique Identifiers (GUIDs) to supported drivers for Bluetooth-enabled devices. Enabling a service installs the corresponding device driver and disabling a service removes the corresponding device driver. If a non-supported service is enabled, a driver is not installed.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h) |
| Library | Bthprops.lib |
| DLL | bthprops.cpl |
See also
BLUETOOTH_DEVICE_SEARCH_PARAMS