BluetoothSetServiceState 함수(bluetoothapis.h)

아티클
08/22/2023

BluetoothSetServiceState 함수는 Bluetooth 디바이스에 대한 서비스를 사용하거나 사용하지 않도록 설정합니다.

구문

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

매개 변수

hRadio

로컬 Bluetooth 라디오의 핸들입니다.

pbtdi

BLUETOOTH_DEVICE_INFO 구조체에 대한 포인터입니다. 이전에 찾은 라디오 주소여야 합니다.

pGuidService

원격 디바이스의 서비스 GUID에 대한 포인터입니다.

dwServiceFlags

서비스를 조정하는 플래그입니다. 서비스를 사용하지 않도록 설정하려면 를 BLUETOOTH_SERVICE_DISABLE. 서비스를 사용하도록 설정하려면 를 BLUETOOTH_SERVICE_ENABLE.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다. 다음 표에서는 일반적인 오류를 나열합니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	dwServiceFlags가 잘못되었습니다.
ERROR_SERVICE_DOES_NOT_EXIST	pGuidService에 지정된 GUID는 지원되지 않습니다.
E_INVALIDARG	dwServiceFlags 가 BLUETOOTH_SERVICE_DISABLE 설정되고 서비스가 이미 비활성화되었거나 dwServiceFlags 가 BLUETOOTH_SERVICE_ENABLE 설정되어 있고 서비스가 이미 활성화되어 있습니다.

설명

Windows는 Bluetooth 지원 디바이스에 지원되는 드라이버에 대한 GUID(Globally Unique Identifiers) 서비스 매핑을 유지 관리합니다. 서비스를 사용하도록 설정하면 해당 디바이스 드라이버가 설치되고 서비스를 사용하지 않도록 설정하면 해당 디바이스 드라이버가 제거됩니다. 지원되지 않는 서비스를 사용하도록 설정하면 드라이버가 설치되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함)
라이브러리	Bthprops.lib
DLL	bthprops.cpl