BluetoothSdpGetString 함수(bluetoothapis.h)

  • 아티클

BluetoothSdpGetString 함수는 SDP 레코드에 포함된 원시 문자열을 유니코드 문자열로 변환합니다.

구문

DWORD BluetoothSdpGetString(
  [in]      LPBYTE                      pRecordStream,
  [in]      ULONG                       cbRecordLength,
  [in]      const PSDP_STRING_TYPE_DATA pStringData,
  [in]      USHORT                      usStringOffset,
  [out]     PWSTR                       pszString,
  [in, out] PULONG                      pcchStringLength
);

매개 변수

[in] pRecordStream

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

[in] cbRecordLength

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

[in] pStringData

NULL로 설정하면 호출 스레드 로캘이 SDP 레코드에서 일치하는 문자열을 검색하는 데 사용됩니다. NULL이 아니면 SDP_STRING_TYPE_DATA 구조체의 mibeNum 및 attributeId 멤버를 사용하여 변환할 문자열을 찾습니다.

[in] usStringOffset

변환할 SDP 문자열 형식 오프셋입니다. usStringOffset은 문자열의 기본 특성 식별자에 추가됩니다. SDP 사양 정의 오프셋은 STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET 및 STRING_PROVIDER_NAME_OFFSET. 이러한 오프셋은 bthdef.h 헤더 파일에서 찾을 수 있습니다.

[out] pszString

NULL이 아닌 경우 는 출력에 변환된 문자열을 포함합니다. NULL로 설정하면 pcchStringLength 매개 변수는 변환된 문자열을 검색하기 위해 바이트가 아닌 필요한 문자 수로 채워집니다.

[in, out] pcchStringLength

입력에서 pszString이 NULL이 아닌 경우 pszString의 길이를 문자로 포함합니다.

출력 시 에는 오류가 반환되는 경우 NULL을 비롯한 필수 문자 수 또는 NULL을 포함하여 pszString에 기록된 문자 수가 포함됩니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환합니다. pszString 매개 변수에 변환된 문자열이 포함되어 있습니다. 실패 시 오류 코드를 반환합니다. 일반적인 오류는 다음 표에 나와 있습니다.

반환 코드 설명
ERROR_MORE_DATA
 pszString 매개 변수가 NULL이거나 변환된 문자열을 포함하기에는 너무 작습니다. pcchStringLength 매개 변수에는 필요한 길이(문자)가 포함됩니다.
ERROR_INVALID_DATA
 변환할 수 없는 경우
ERROR_NO_SYSTEM_RESOURCES
 시스템에서 내부적으로 메모리를 할당하여 변환을 수행할 수 없습니다.
ERROR_INVALID_PARAMETER
 필요한 포인터 중 하나는 NULL이거나, pRecordStream 매개 변수가 유효한 SDP 스트림이 아니거나, pRecordStream 이 올바른 형식의 레코드가 아니거나, 요청된 특성 더하기 오프셋이 문자열이 아니었습니다.

요구 사항

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

추가 정보

BluetoothSdpEnumAttributes

BluetoothSdpGetAttributeValue

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA