Bluetooth dan WSALookupServiceBegin untuk Pertanyaan Perangkat

Topik ini menjelaskan cara menggunakan fungsi WSALookupServiceBegin untuk melakukan penyelidikan perangkat yang terlihat dan hantu. Untuk informasi selengkapnya, lihat Menemukan Perangkat dan Layanan Bluetooth.

Fungsi WSALookupServiceBegin menggunakan struktur WSAQUERYSET dalam parameter pertamanya, lpqsRestrictions, untuk menentukan kriteria pencarian. Bluetooth menyediakan panduan khusus untuk penggunaan fungsi WSALookupServiceBegin dan WSAQUERYSET.

Tabel berikut mencantumkan pembatasan yang berlaku untuk struktur WSAQUERYSET yang diteruskan ke parameter lpqsRestrictions saat mengkueri perangkat.

Anggota WSAQUERYSET Pembatasan
dwSize Atur ke sizeof(WSAQUERYSET).
lpBlob Anggota ini berisi penunjuk opsional ke struktur BLOB . Jika anggota ini ditentukan, parameter pertanyaan perangkat yang valid untuk LUP_FLUSHCACHE adalah sebagai berikut:
  • Anggota cbSize dari struktur BLOB harus sizeof(BTH_QUERY_DEVICE).
  • Anggota pBlobData adalah penunjuk ke struktur BTH_QUERY_DEVICE, di mana anggota LAP adalah kode akses pertanyaan Bluetooth, dan anggota panjangnya adalah panjangnya, dalam hitungan detik, dari pertanyaan.
dwNameSpace Atur ke NS_BTH.
Anggota lain Anggota lain dari struktur WSAQUERYSET diabaikan.

 

Bendera yang tercantum dalam tabel berikut digunakan dalam parameter dwControlFlags untuk mengontrol hasil kueri. Bendera LUP_CONTAINERS dan LUP_FLUSHCACHE digunakan oleh fungsi WSALookupServiceBegin; bendera lainnya digunakan dalam panggilan ke fungsi WSALookupServiceNext.

Bendera Hasil
LUP_CONTAINERS Menentukan bahwa tujuan kueri adalah untuk mendapatkan daftar perangkat Bluetooth dan bukan daftar layanan. Bendera ini harus diatur.
LUP_FLUSHCACHE Memicu pertanyaan perangkat lokal atau menyebabkan hasil cache dari kueri sebelumnya dikembalikan.
LUP_RETURN_TYPE Kembalikan BLUETOOTH COD (kelas bit perangkat) langsung di anggota lpServiceClassId dari struktur WSAQUERYSET . COD dipetakan ke anggota Data1 GUID.
LUP_RES_SERVICE Mengembalikan informasi untuk alamat Bluetooth lokal. Bendera ini hanya berpengaruh jika LUP_RETURN_ADDR juga ditentukan.
LUP_RETURN_NAME Mengembalikan nama tampilan perangkat dalam anggota lpszServiceInstanceName dari struktur WSAQUERYSET untuk setiap panggilan ke fungsi WSALookupServiceNext. Bendera ini juga harus ditentukan untuk mengambil nama anggota struktur BTH_DEVICE_INFO saat menentukan bendera LUP_RETURN_BLOB.
LUP_RETURN_ADDR Mengembalikan struktur SOCKADDR_BTH yang berisi alamat 48-bit serekan di anggota lpcsaBuffer dari struktur WSAQUERYSET untuk setiap panggilan ke fungsi WSALookupServiceNext. Anggota lain dalam struktur SOCKADDR_BTH akan kosong.
LUP_RETURN_BLOB Mengembalikan struktur BTH_DEVICE_INFO pada setiap panggilan berikutnya ke WSALookupServiceNext.
LUP_FLUSHPREVIOUS Lewati perangkat berikutnya yang tersedia, dan kembalikan perangkat yang mengikutinya.

 

Bluetooth dan WSALookupServiceBegin untuk Penemuan Layanan

Bluetooth dan WSALookupServiceNext

Bluetooth dan WSAQUERYSET untuk Pertanyaan Perangkat

Menemukan Perangkat dan Layanan Bluetooth

WSALookupServiceBegin

WSALookupServiceNext

WSALookupServiceEnd

BLOB

BTH_QUERY_DEVICE

SOCKADDR_BTH

WSAQUERYSET

Soket Windows