BluetoothRegisterForAuthentication 함수(bluetoothapis.h)

아티클
02/26/2024

BluetoothRegisterForAuthentication 함수는 특정 Bluetooth 디바이스가 인증을 요청할 때 호출되는 콜백 함수를 등록합니다.

참고 Windows Vista SP2 및 Windows 7용으로 개발할 때 BluetoothRegisterForAuthenticationEx 를 사용하는 것이 좋습니다.

구문

DWORD BluetoothRegisterForAuthentication(
  const BLUETOOTH_DEVICE_INFO            *pbtdi,
  HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandle,
  PFN_AUTHENTICATION_CALLBACK            pfnCallback,
  PVOID                                  pvParam
);

매개 변수

pbtdi

BLUETOOTH_DEVICE_INFO 구조체에 대한 포인터입니다. Address 멤버는 비교에 사용됩니다.

phRegHandle

등록 HANDLE이 저장되는 구조체에 대한 포인터입니다. BluetoothUnregisterAuthentication을 호출하여 핸들을 닫습니다.

pfnCallback

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

pvParam

콜백 함수를 통해 전달할 선택적 매개 변수입니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환하고 유효한 등록 핸들이 phRegHandle에 반환되었습니다. 다른 반환 값은 실패를 나타냅니다.

GetLastError 함수를 호출하여 오류에 대한 자세한 정보를 가져옵니다. 다음 표에서는 일반적인 오류를 설명합니다.

반환 코드	설명
ERROR_OUTOFMEMORY	메모리가 부족합니다.

요구 사항

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