BluetoothSdpEnumAttributes (bluetoothapis.h)

Artikel
03/04/2024

Fungsi BluetoothSdpEnumAttributes menghitung melalui aliran rekaman SDP, dan memanggil fungsi panggilan balik untuk setiap atribut dalam rekaman.

Sintaks

BOOL BluetoothSdpEnumAttributes(
  LPBYTE                                 pSDPStream,
  ULONG                                  cbStreamSize,
  PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK pfnCallback,
  LPVOID                                 pvParam
);

Parameter

pSDPStream

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

cbStreamSize

Ukuran aliran yang ditujukkan oleh pSDPStream, dalam byte.

pfnCallback

Arahkan ke rutinitas panggilan balik. Lihat PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK untuk informasi selengkapnya tentang panggilan balik.

pvParam

Parameter opsional yang akan diteruskan ke rutinitas panggilan balik.

Nilai kembali

Mengembalikan TRUE jika terjadi enumerasi. Mengembalikan FALSE setelah kegagalan. Panggil fungsi GetLastError untuk informasi selengkapnya. Tabel berikut menjelaskan kode kesalahan umum yang terkait dengan fungsi BluetoothSdpEnumAttributes :

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter pSDPStream atau pfnCallback adalah NULL.
ERROR_INVALID_DATA	Aliran SDP rusak.

Keterangan

Jika fungsi panggilan balik mengembalikan FALSE, enumerasi yang dimulai oleh fungsi BluetoothSdpEnumAttributes dihentikan.

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

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