BluetoothSdpGetAttributeValue 함수(bluetoothapis.h)

아티클
08/22/2023

BluetoothSdpGetAttributeValue 함수는 특성 식별자에 대한 특성 값을 검색합니다.

구문

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

매개 변수

[in] pRecordStream

단일 SDP 레코드로 형식이 지정된 유효한 레코드 스트림에 대한 포인터입니다.

[in] cbRecordLength

pRecordStream의 길이(바이트)입니다.

[in] usAttributeId

검색할 특성 식별자입니다. 설명 부분을 참조하세요.

[out] pAttributeData

특성의 식별자 값이 배치되는 SDP_ELEMENT_DATA 구조체에 대한 포인터입니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다. pAddributeData 매개 변수에는 특성 값이 포함됩니다. 다른 반환 값은 오류를 나타냅니다. 다음 표에서는 BluetoothSdpGetAttributeValue 함수와 관련된 일반적인 오류 코드에 대해 설명합니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	필요한 포인터 중 하나가 NULL이거나, pRecordStream 매개 변수가 유효한 SDP 스트림이 아니거나, pRecordStream 매개 변수가 올바르게 형식이 지정된 SDP 레코드가 아니었습니다.
ERROR_FILE_NOT_FOUND	usAttributeId에 제공된 식별자를 레코드에서 찾을 수 없습니다.

설명

pRecordStream의 레코드 스트림은 SDP 레코드 형식의 SDP 스트림이어야 하며, 특성 ID(UINT16)와 특성 값(모든 SDP 요소 형식) 쌍을 포함하는 SEQUENCE여야 합니다.

usAttributeId 매개 변수에 제공된 특성 식별자는 bthdef.h 파일에 제공된 여러 SDP_ATTRIB_Xxx 범용 특성 식별자 또는 Bluetooth 프로필에서 정의한 사용자 지정 특성 값 중 하나일 수 있습니다. 0x200 보다 크거나 같은 모든 값은 프로필별 특성 식별자이며 프로필과 관련이 있습니다. 범용 SDP 특성 식별자 목록은 bthdef.h 헤더 파일을 참조하세요.

요구 사항

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