다음을 통해 공유

BluetoothRegisterForAuthenticationEx 함수(bluetoothapis.h)

  • 아티클

BluetoothRegisterForAuthenticationEx 함수는 핀 요청, 숫자 비교 및 콜백 함수에 대한 애플리케이션을 등록합니다.

참고 이 API는 Windows Vista SP2 및 Windows 7에서 지원됩니다.
 

구문

DWORD BluetoothRegisterForAuthenticationEx(
  [in, optional] const BLUETOOTH_DEVICE_INFO            *pbtdiIn,
  [out]          HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandleOut,
  [in, optional] PFN_AUTHENTICATION_CALLBACK_EX         pfnCallbackIn,
  [in, optional] PVOID                                  pvParam
);

매개 변수

[in, optional] pbtdiIn

비교에 사용할 bluetooth 주소를 지정하는 BLUETOOTH_DEVICE_INFO 구조체에 대한 포인터입니다.

[out] phRegHandleOut

등록된 애플리케이션과 연결된 HBLUETOOTH_AUTHENTICATION_REGISTRATION 핸들에 대한 포인터입니다. BluetoothUnregisterAuthentication을 호출하여 핸들을 닫습니다.

[in, optional] pfnCallbackIn

인증 이벤트가 발생할 때 호출될 함수입니다. 이 함수는 PFN_AUTHENTICATION_CALLBACK_EX 프로토타입과 일치해야 합니다.

[in, optional] pvParam

pfnCallbackIn에서 지정한 콜백 함수로 전달할 선택적 매개 변수입니다. 이 매개 변수는 애플리케이션이 정의하는 데 필요한 모든 항목일 수 있습니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다. 는 실패 시 다음 오류 코드를 반환합니다.

반환 코드 설명
ERROR_OUTOFMEMORY
 메모리가 부족합니다.
Win32 오류
 제공된 등록 핸들이 잘못되었습니다.

설명

호출자는 유효한 콜백 주소를 제공해야 하며 알림이 더 이상 필요하지 않은 경우 콜백의 등록을 취소해야 합니다. 인증된 디바이스의 등록 취소는 BluetoothUnregisterAuthentication을 호출하여 수행할 수 있습니다.

애플리케이션이 인증을 두 번 이상 등록하는 시나리오에서는 인증이 진행되는 동안 이 함수를 통해 등록된 첫 번째 콜백 함수만 애플리케이션에서 호출됩니다.

요구 사항

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

추가 정보

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication