BluetoothSelectDevices 함수(bluetoothapis.h)

  • 아티클

BluetoothSelectDevices 함수를 사용하면 Bluetooth 디바이스를 선택할 수 있습니다.

구문

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

매개 변수

pbtsdp

Bluetooth 디바이스를 식별하는 BLUETOOTH_SELECT_DEVICE_PARAMS 구조체에 대한 포인터입니다.

반환 값

사용자가 디바이스를 선택한 경우 TRUE 를 반환합니다.

유효한 데이터가 반환되지 않은 경우 FALSE 를 반환합니다. GetLastError 함수를 호출하여 오류 정보를 검색합니다. 반환된 오류 정보에는 다음 조건이 적용됩니다.

반환 코드 설명
ERROR_CANCELLED
 사용자가 요청을 취소했습니다.
ERROR_INVALID_PARAMETER
 pbtsdp 매개 변수는 NULL입니다.
ERROR_REVISION_MISMATCH
 pbtsdp로 전달된 구조체의 크기는 알 수 없습니다.

설명

BluetoothSelectDevices 함수는 Bluetooth 디바이스를 선택하는 일반적인 대화 상자를 엽니다. 사용자에게 표시되는 디바이스 목록은 호출자가 pbtsdp 매개 변수에 지정하는 플래그 및 설정에 따라 결정됩니다.

BluetoothSelectDevices가 TRUE를 반환하는 경우 BLUETOOTH_SELECT_DEVICE_PARAMS 구조체의 pDevices 멤버는 유효한 데이터를 가리킵니다. 호출자는 BLUETOOTH_SELECT_DEVICE_PARAMS 구조에서 fAuthenticated 및 fRemembered 플래그를 확인하여 성공적으로 인증된 디바이스와 사용자에게 유효한 디바이스를 확인해야 합니다. BluetoothSelectDevices 함수가 TRUE를 반환하는 경우에만 BluetoothSelectDevicesFree 함수를 호출하여 리소스를 해제합니다.

요구 사항

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

추가 정보

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK