BluetoothRegisterForAuthenticationEx 함수(bluetoothapis.h)
BluetoothRegisterForAuthenticationEx 함수는 핀 요청, 숫자 비교 및 콜백 함수에 대한 애플리케이션을 등록합니다.
구문
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 반환합니다. 는 실패 시 다음 오류 코드를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
메모리가 부족합니다. |
|
제공된 등록 핸들이 잘못되었습니다. |
설명
호출자는 유효한 콜백 주소를 제공해야 하며 알림이 더 이상 필요하지 않은 경우 콜백의 등록을 취소해야 합니다. 인증된 디바이스의 등록 취소는 BluetoothUnregisterAuthentication을 호출하여 수행할 수 있습니다.
애플리케이션이 인증을 두 번 이상 등록하는 시나리오에서는 인증이 진행되는 동안 이 함수를 통해 등록된 첫 번째 콜백 함수만 애플리케이션에서 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함) |
| 라이브러리 | Bthprops.lib |
| DLL | bthprops.cpl |