BluetoothSelectDevices 함수(bluetoothapis.h)
BluetoothSelectDevices 함수를 사용하면 Bluetooth 디바이스를 선택할 수 있습니다.
구문
BOOL BluetoothSelectDevices(
BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);
매개 변수
pbtsdp
Bluetooth 디바이스를 식별하는 BLUETOOTH_SELECT_DEVICE_PARAMS 구조체에 대한 포인터입니다.
반환 값
사용자가 디바이스를 선택한 경우 TRUE 를 반환합니다.
유효한 데이터가 반환되지 않은 경우 FALSE 를 반환합니다. GetLastError 함수를 호출하여 오류 정보를 검색합니다. 반환된 오류 정보에는 다음 조건이 적용됩니다.
| 반환 코드 | 설명 |
|---|---|
|
사용자가 요청을 취소했습니다. |
|
pbtsdp 매개 변수는 NULL입니다. |
|
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 |