BluetoothFindFirstRadio 함수(bluetoothapis.h)
BluetoothFindFirstRadio 함수는 로컬 Bluetooth 라디오의 열거를 시작합니다.
구문
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
[out] HANDLE *phRadio
);
매개 변수
pbtfrp
BLUETOOTH_FIND_RADIO_PARAMS 구조체에 대한 포인터입니다. pbtfrp에서 가리키는 BLUETOOTH_FIND_RADIO_PARAMS 구조체의 dwSize 멤버는 구조체의 크기와 일치해야 합니다.
[out] phRadio
첫 번째 열거형 라디오 핸들이 반환되는 위치에 대한 포인터입니다. 더 이상 필요하지 않은 경우 CloseHandle을 통해 이 핸들을 닫아야 합니다.
반환 값
phRadio에서 나타내는 핸들 외에도 이 함수를 호출하면 BluetoothFindNextRadio 함수와 함께 사용할 HBLUETOOTH_RADIO_FIND 핸들도 생성됩니다. 이 핸들이 더 이상 필요하지 않은 경우 BluetoothFindRadioClose를 통해 닫혀야 합니다.
실패 시 NULL 을 반환합니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 다음 표에서는 일반적인 오류를 설명합니다.
| 반환 코드 | 설명 |
|---|---|
|
Bluetooth 라디오를 찾을 수 없습니다. |
|
pbtfrp 매개 변수는 NULL입니다. |
|
pbtfrp에서 가리키는 구조체가 올바른 크기가 아닙니다. |
|
메모리가 부족합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함) |
| 라이브러리 | Bthprops.lib |
| DLL | bthprops.cpl |