다음을 통해 공유


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 매개 변수에 지정하는 플래그 및 설정에 따라 결정됩니다.

BluetoothSelectDevicesTRUE를 반환하는 경우 BLUETOOTH_SELECT_DEVICE_PARAMS 구조체의 pDevices 멤버는 유효한 데이터를 가리킵니다. 호출자는 BLUETOOTH_SELECT_DEVICE_PARAMS 구조에서 fAuthenticatedfRemembered 플래그를 확인하여 성공적으로 인증된 디바이스와 사용자에게 유효한 디바이스를 확인해야 합니다. 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