BluetoothSdpGetString (bluetoothapis.h)

Artikel
08/22/2023

Fungsi BluetoothSdpGetString mengonversi string mentah yang disematkan dalam rekaman SDP menjadi string Unicode.

Sintaks

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
);

Parameter

[in] pRecordStream

Penunjuk ke aliran rekaman valid yang diformat sebagai satu rekaman SDP.

[in] cbRecordLength

Panjangnya, dalam byte, dari pRecordStream.

[in] pStringData

Saat diatur ke NULL, lokal utas panggilan digunakan untuk mencari string yang cocok dalam catatan SDP. Jika bukan NULL, anggota mibeNum dan attributeId dari struktur SDP_STRING_TYPE_DATA digunakan untuk menemukan string yang akan dikonversi.

[in] usStringOffset

Offset jenis string SDP untuk dikonversi. usStringOffset ditambahkan ke pengidentifikasi atribut dasar string. Offset yang ditentukan spesifikasi SDP adalah: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET, dan STRING_PROVIDER_NAME_OFFSET. Offset ini dapat ditemukan di file header bthdef.h.

[out] pszString

Jika bukan NULL, berisi string yang dikonversi pada output. Ketika diatur ke NULL, parameter pcchStringLength diisi dengan jumlah karakter yang diperlukan, bukan byte, untuk mengambil string yang dikonversi.

[in, out] pcchStringLength

Pada input, berisi panjang pszString jika pszString bukan NULL, dalam karakter.

Setelah output, berisi jumlah karakter yang diperlukan termasuk NULL jika kesalahan dikembalikan, atau jumlah karakter yang ditulis ke pszString, termasuk NULL.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan; parameter pszString berisi string yang dikonversi. Mengembalikan kode kesalahan setelah kegagalan. Kesalahan umum tercantum dalam tabel berikut.

Menampilkan kode	Deskripsi
ERROR_MORE_DATA	Parameter pszStringadalah NULL atau terlalu kecil untuk berisi string yang dikonversi; parameter pcchStringLength berisi, dalam karakter, panjang yang diperlukan.
ERROR_INVALID_DATA	Konversi tidak dapat dilakukan.
ERROR_NO_SYSTEM_RESOURCES	Sistem tidak dapat mengalokasikan memori secara internal untuk melakukan konversi.
ERROR_INVALID_PARAMETER	Salah satu penunjuk yang diperlukan adalah NULL, parameter pRecordStream bukan aliran SDP yang valid, pRecordStream bukan rekaman yang diformat dengan benar, atau atribut yang diminta ditambah offset bukan string.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	bluetoothapis.h (termasuk Bthsdpdef.h, BluetoothAPIs.h)
Pustaka	Bthprops.lib
DLL	bthprops.cpl

Lihat juga

BluetoothSdpEnumAttributes

BluetoothSdpGetAttributeValue

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA