BluetoothSdpGetAttributeValue (bluetoothapis.h)

Artikel
02/26/2024

Fungsi BluetoothSdpGetAttributeValue mengambil nilai atribut untuk pengidentifikasi atribut.

Sintaks

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

Parameter

[in] pRecordStream

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

[in] cbRecordLength

Panjang pRecordStream, dalam byte.

[in] usAttributeId

Pengidentifikasi atribut untuk dicari. Lihat Keterangan.

[out] pAttributeData

Penunjuk ke struktur SDP_ELEMENT_DATA tempat nilai pengidentifikasi atribut ditempatkan.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan; parameter pAddributeData berisi nilai atribut. Nilai pengembalian lainnya menunjukkan kesalahan. Tabel berikut menjelaskan kode kesalahan umum yang terkait dengan fungsi BluetoothSdpGetAttributeValue :

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Salah satu pointer yang diperlukan adalah NULL, parameter pRecordStream bukan aliran SDP yang valid, atau parameter pRecordStream bukan rekaman SDP yang diformat dengan benar.
ERROR_FILE_NOT_FOUND	Pengidentifikasi yang disediakan di usAttributeId tidak ditemukan dalam rekaman.

Keterangan

Aliran rekaman di pRecordStream harus berupa aliran SDP yang diformat sebagai rekaman SDP, SEQUENCE yang berisi pasangan ID atribut (UINT16) plus nilai atribut (jenis elemen SDP apa pun).

Pengidentifikasi atribut yang disediakan dalam parameter usAttributeId dapat menjadi salah satu dari banyak pengidentifikasi atribut universal SDP_ATTRIB_Xxx yang disediakan dalam file bthdef.h, atau nilai atribut kustom yang ditentukan oleh profil Bluetooth. Semua nilai yang lebih besar dari atau sama dengan 0x200 adalah pengidentifikasi atribut khusus profil, dan khusus untuk profil. Lihat file header bthdef.h untuk daftar pengidentifikasi atribut SDP universal.

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