BluetoothSendAuthenticationResponse 함수(bluetoothapis.h)

아티클
08/22/2023

BluetoothSendAuthenticationResponse 함수는 암호 응답을 보내는 인증 요청이 수신될 때 호출됩니다.

참고 Windows Vista SP2 및 Windows 7용으로 개발하는 경우 BluetoothSendAuthenticationResponseEx를 사용하는 것이 좋습니다.

구문

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

매개 변수

hRadio

로컬 라디오 핸들 또는 NULL에 대한 선택적 핸들입니다. NULL인 경우 함수는 모든 로컬 라디오에서 인증 응답을 보내려고 시도합니다.

pbtdi

인증되는 Bluetooth 디바이스를 설명하는 BLUETOOTH_DEVICE_INFO 구조에 대한 포인터입니다. 콜백 함수에 전달된 구조와 동일한 구조체일 수 있습니다.

pszPasskey

인증 디바이스로 다시 보낼 암호 응답의 UNICODE 0으로 끝나는 문자열에 대한 포인터입니다. pszPasskey 매개 변수는 NULL을 제외하고 BLUETOOTH_MAX_PASSKEY_SIZE 초과할 수 없습니다. ANSI로의 변환이 수행되면 pszPasskey 매개 변수는 NULL을 제외하고 16바이트보다 클 수 없습니다.

반환 값

디바이스가 암호 응답을 수락하면 ERROR_SUCCESS 반환합니다. 디바이스가 인증됩니다. 다른 반환 값은 실패를 나타냅니다. 다음 표에서는 일반적인 오류를 설명합니다.

반환 코드	설명
ERROR_CANCELLED	Bluetooth 디바이스에서 암호 응답을 거부했습니다. 이 오류는 로컬 라디오에 통신 문제가 있는 경우에도 반환됩니다.
E_FAIL	디바이스는 인증 중에 오류 코드를 반환했습니다.

요구 사항

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