BluetoothGetDeviceInfo 함수(bluetoothapis.h)

아티클
08/22/2023

BluetoothGetDeviceInfo 함수는 원격 Bluetooth 디바이스에 대한 정보를 검색합니다. Bluetooth 디바이스는 이전에 성공적인 디바이스 조회 함수 호출을 통해 식별되어야 합니다.

구문

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

매개 변수

hRadio

BluetoothFindFirstRadio 또는 유사한 함수를 호출하거나 SetupDiEnumerateDeviceInterfaces 함수 호출에서 가져온 로컬 라디오에 대한 핸들입니다.

pbtdi

첫 번째 Bluetooth 디바이스에 대한 데이터를 배치할 BLUETOOTH_DEVICE_INFO 구조체에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

성공 시 ERROR_SUCCESS 반환하며, 이는 원격 Bluetooth 디바이스에 대한 데이터가 검색되었음을 나타냅니다. 실패 시 오류 코드를 반환합니다. 다음 표에서는 BluetoothGetDeviceInfo 함수와 연결된 일반적인 오류 코드를 나열합니다.

반환 코드	설명
ERROR_REVISION_MISMATCH	BLUETOOTH_DEVICE_INFO 크기가 호환되지 않습니다. BLUETOOTH_DEVICE_INFO 구조체의 dwSize 멤버를 확인합니다.
ERROR_NOT_FOUND	시스템에서 라디오를 알 수 없거나 BLUETOOTH_DEVICE_INFO 구조체의 Address 멤버가 모두 0입니다.
ERROR_INVALID_PARAMETER	pbtdi 매개 변수는 NULL입니다.

설명

데이터를 가져오는 Bluetooth 디바이스는 이전에 성공적인 디바이스 조회 함수 호출을 통해 식별되어야 합니다.

pbtdi가 가리키는 BLUETOOTH_DEVICE_INFO 구조체에서 dwSize 멤버는 구조체의 크기(바이트)와 동일해야 합니다. BLUETOOTH_DEVICE_INFO 구조체의 주소 멤버는 원격 디바이스의 Bluetooth 주소를 포함해야 합니다.

요구 사항

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