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 함수를 호출합니다. 다음 표에서는 일반적인 오류를 설명합니다.

반환 코드 설명
ERROR_NO_MORE_ITEMS
 Bluetooth 라디오를 찾을 수 없습니다.
ERROR_INVALID_PARAMETER
 pbtfrp 매개 변수는 NULL입니다.
ERROR_REVISION_MISMATCH
 pbtfrp에서 가리키는 구조체가 올바른 크기가 아닙니다.
ERROR_OUTOFMEMORY
 메모리가 부족합니다.

요구 사항

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

추가 정보

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError