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 매개 변수에 변환된 문자열이 포함되어 있습니다. 실패 시 오류 코드를 반환합니다. 일반적인 오류는 다음 표에 나와 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
pszString 매개 변수가 NULL이거나 변환된 문자열을 포함하기에는 너무 작습니다. pcchStringLength 매개 변수에는 필요한 길이(문자)가 포함됩니다. |
|
변환할 수 없는 경우 |
|
시스템에서 내부적으로 메모리를 할당하여 변환을 수행할 수 없습니다. |
|
필요한 포인터 중 하나는 NULL이거나, pRecordStream 매개 변수가 유효한 SDP 스트림이 아니거나, pRecordStream 이 올바른 형식의 레코드가 아니거나, 요청된 특성 더하기 오프셋이 문자열이 아니었습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함) |
| 라이브러리 | Bthprops.lib |
| DLL | bthprops.cpl |