BluetoothFindFirstDevice 함수(bluetoothapis.h)

아티클
02/26/2024

BluetoothFindFirstDevice 함수는 Bluetooth 디바이스 열거를 시작합니다.

구문

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

매개 변수

pbtsp

BLUETOOTH_DEVICE_SEARCH_PARAMS 구조체에 대한 포인터입니다. pbtsp가 가리키는 BLUETOOTH_DEVICE_SEARCH_PARAMS 구조체의 dwSize 멤버는 구조체의 크기와 일치해야 합니다.

pbtdi

발견된 첫 번째 Bluetooth 디바이스에 대한 정보가 배치되는 BLUETOOTH_DEVICE_INFO 구조에 대한 포인터입니다. pbtdi가 가리키는 BLUETOOTH_DEVICE_INFO 구조체의 dwSize 멤버는 구조체의 크기와 일치해야 합니다. 그렇지 않으면 BluetoothFindFirstDevice 함수에 대한 호출이 실패합니다.

반환 값

성공적으로 완료되면 첫 번째 Bluetooth 디바이스에 유효한 핸들을 반환하고 pbtdi 매개 변수는 디바이스에 대한 정보를 가리킵니다. 이 핸들이 더 이상 필요하지 않으면 BluetoothFindDeviceClose를 통해 닫혀야 합니다.

실패 시 NULL 을 반환합니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. 다음 표에서는 일반적인 오류를 설명합니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	pbtsp 또는 pbtdi 매개 변수는 NULL입니다.
ERROR_REVISION_MISMATCH	pbtsp 또는 pbtdi가 가리키는 구조체가 올바른 크기가 아닙니다.

설명

BluetoothFindFirstDevice 함수는 BLUEtooth LE(저에너지) 장치를 찾을 수 없습니다. Bluetooth LE 디바이스에 액세스하려면 Windows 런타임 Bluetooth 저에너지 API를 사용합니다. Bluetooth용 Windows 런타임 API는 UWP 및 클래식 데스크톱 앱 모두에서 작동합니다.

요구 사항

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