BluetoothAuthenticateMultipleDevices 함수(bluetoothapis.h)

아티클
02/23/2024

BluetoothAuthenticateMultipleDevices 함수를 사용하면 호출자가 Bluetooth 연결 마법사의 단일 instance 동안 여러 디바이스를 인증하라는 메시지를 표시할 수 있습니다.

참고BluetoothAuthenticateMultipleDevices 는 더 이상 사용되지 않습니다. 이 API의 구현은 권장되지 않습니다.

구문

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

매개 변수

hwndParent

인증 마법사의 부모가 될 창입니다. NULL로 설정하면 마법사가 바탕 화면에서 부모로 설정됩니다.

hRadio

유효한 로컬 라디오 핸들 또는 NULL입니다. NULL이면 모든 로컬 라디오에서 인증을 시도합니다. 라디오가 성공하면 함수 호출이 성공합니다.

cDevices

BLUETOOTH_DEVICE_INFO 구조체의 pbtdi 배열에 있는 디바이스 수입니다.

rgbtdi

인증할 Bluetooth 디바이스에 대한 레코드를 포함하는 BLUETOOTH_DEVICE_INFO 구조체의 배열입니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다. 각 디바이스에 대한 fAuthenticate 플래그를 검사.

다음 표에서는 일반적인 오류를 나열합니다.

반환 코드	설명
ERROR_CANCELLED	사용자가 작업을 취소했습니다. 각 Bluetooth 디바이스에 대한 fAuthenticate 플래그를 확인하여 사용자가 작업을 취소하기 전에 디바이스가 인증되었는지 확인합니다.
ERROR_INVALID_PARAMETER	pbtdi 배열에 있는 하나 이상의 디바이스가 잘못되었습니다.
ERROR_NO_MORE_ITEMS	pbtdi가 가리키는 모든 디바이스는 이미 인증된 것으로 표시됩니다.

요구 사항

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