BluetoothEnableDiscovery 함수(bluetoothapis.h)

아티클
02/23/2024

BluetoothEnableDiscovery 함수는 로컬 Bluetooth 라디오 또는 라디오의 검색 상태를 변경합니다.

구문

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

매개 변수

hRadio

유효한 로컬 라디오 핸들 또는 NULL입니다. NULL이면 모든 로컬 라디오에서 검색이 수정됩니다. 호출에 의해 라디오가 수정되면 함수 호출이 성공합니다.

fEnabled

검색을 사용할지 아니면 사용하지 않도록 설정할지 여부를 지정하는 플래그입니다. 검색을 사용하도록 설정하려면 TRUE 로 설정하고 FALSE로 설정 하여 검색을 사용하지 않도록 설정합니다.

반환 값

검색 상태가 성공적으로 변경된 경우 TRUE 를 반환합니다. hRadio가 NULL인 경우 반환 값 TRUE는 하나 이상의 로컬 라디오 상태가 성공적으로 변경되었음을 나타냅니다. 검색 상태가 변경되지 않은 경우 FALSE 를 반환합니다. hRadio 가 NULL이면 상태 변경을 수락한 라디오가 없습니다.

설명

BluetoothIsDiscoverable 함수를 사용하여 Bluetooth 라디오의 현재 상태를 확인합니다. Windows는 검색 가능한 시스템을 연결할 수 있도록 보장하며, 따라서 라디오는 라디오를 검색할 수 있도록 하기 전에 들어오는 연결을 허용해야 합니다. 들어오는 연결을 허용하지 않으면 BluetoothEnableDiscovery 함수 호출이 실패합니다.

BluetoothEnableDiscovery가 검색 상태를 변경하면 호출 애플리케이션의 수명 동안 새 상태가 유효합니다. 또한 이전에 이 함수를 사용하여 검색 가능하도록 만든 Bluetooth 라디오를 사용하지 않도록 설정하고 애플리케이션을 통해 다시 사용하도록 설정한 경우 검색 가능성이 유지되지 않습니다. 호출 애플리케이션이 종료되면 지정된 Bluetooth 라디오의 검색 상태가 BluetoothEnableDiscovery 가 호출되기 전의 상태로 되돌아갑니다.

요구 사항

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