bluetoothSetServiceState 函式 (bluetoothapis.h)

發行項
02/26/2024

BluetoothSetServiceState 函式會啟用或停用藍牙裝置的服務。

語法

DWORD BluetoothSetServiceState(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  const GUID                  *pGuidService,
  DWORD                       dwServiceFlags
);

參數

hRadio

本機藍牙無線電的句柄。

pbtdi

BLUETOOTH_DEVICE_INFO 結構的指標。必須是先前找到的單選位址。

pGuidService

遠端裝置上服務 GUID 的指標。

dwServiceFlags

調整服務的旗標。若要停用服務，請將設定為 BLUETOOTH_SERVICE_DISABLE;若要啟用服務，請將設定為 BLUETOOTH_SERVICE_ENABLE。

傳回值

成功完成時 傳回ERROR_SUCCESS 。下表列出常見的錯誤。

傳回碼	Description
ERROR_INVALID_PARAMETER	dwServiceFlags 無效。
ERROR_SERVICE_DOES_NOT_EXIST	不支援 pGuidService 中指定的 GUID 。
E_INVALIDARG	dwServiceFlags 設定為 BLUETOOTH_SERVICE_DISABLE 且服務已停用，或 dwServiceFlags 設定為 BLUETOOTH_SERVICE_ENABLE 且服務已啟用。

備註

Windows 會維護服務全域唯一標識符 (GUID 的對應，) 支援藍牙裝置的驅動程式。啟用服務會安裝對應的設備驅動器，並停用服務會移除對應的設備驅動器。如果已啟用不支持的服務，則不會安裝驅動程式。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
程式庫	Bthprops.lib
Dll	bthprops.cpl