Bluetooth dan WSAQUERYSET untuk Set Service
Bluetooth menggunakan struktur WSAQUERYSET untuk memfasilitasi penemuan perangkat dan layanan di namespace Bluetooth, NS_BTH.
Fungsi WSASetService menggunakan struktur WSAQUERYSET untuk mendaftarkan atau menghapus instans layanan di namespace Bluetooth. Tabel berikut ini mencantumkan nilai anggota dalam struktur WSAQUERYSET .
Anggota | Nilai yang diperlukan (input) | Hasil |
---|---|---|
dwSize | Harus diatur ke sizeof(WSAQUERYSET). Digunakan sebagai mekanisme penerapan versi. | Tidak ada. |
dwOutputFlags | Tidak digunakan. | Tidak ada. |
lpszServiceInstanceName | Opsional, tetapi direkomendasikan. Digunakan untuk membuat atribut Bluetooth ServiceName. | Tidak ada. |
lpServiceClassId | Harus diisi. GUID yang sesuai dengan kelas layanan. Nilai ini harus sesuai dengan GUID dari dokumen Bluetooth Assigned Numbers untuk profil yang diketahui, atau UUID unik yang dihasilkan aplikasi untuk aplikasi yang tidak berbasis profil. Digunakan untuk membuat urutan atribut ServiceClassIdList dengan ini sebagai satu-satunya anggotanya. | Tidak ada. |
lpVersion | Tidak digunakan. | Tidak ada. |
lpszComment | Opsional. Digunakan untuk membuat atribut Bluetooth ServiceDescription. | Tidak ada. |
dwNameSpace | Namespace untuk membatasi layanan. Pasti NS_BTH. | Tidak ada. |
lpNSProviderId | Tidak wajib. | Tidak ada. |
lpszContext | Tidak digunakan. | Tidak ada. |
dwNumberOfProtocols | Tidak digunakan. | Tidak ada. |
lpafpProtocols | Tidak digunakan. | Tidak ada. |
lpszQueryString | Tidak digunakan. | Tidak ada. |
dwNumberOfCsAddrs | Jumlah alamat yang akan didaftarkan. Harus 1. | Tidak ada. |
lpcsaBuffer | Diperlukan jika lpBlob belum diisi dengan aliran SDP mentah. Arahkan ke struktur CSADDR_INFO dengan anggota LocalAddr.lpSockaddr yang menunjuk ke SOCKADDR_BTH tempat server mendengarkan koneksi. Fungsi getsockname dapat digunakan untuk mengembalikan struktur SOCKADDR_BTH untuk soket terikat. Informasi dalam anggota lpcsaBuffer digunakan oleh sistem untuk membangun atribut Bluetooth ProtocolDescriptorList SDP. Protokol dan port yang disediakan di lpcsaBuffer harus unik (tidak terdaftar sebelumnya), dan digunakan untuk mengindeks rekaman untuk panggilan berikutnya yang akan dihapus. Digunakan untuk membuat atribut Bluetooth ProtocolDescriptorList dari rekaman SDP. | Tidak ada. |
lpBlob | Opsional. Penunjuk ke struktur BLOB yang menunjuk ke struktur BTH_SET_SERVICE, memungkinkan klien untuk menyediakan struktur khusus Bluetooth yang berisi catatan SDP biner yang dibangun oleh aplikasi. Jika lpBlob disediakan untuk fungsi WSASetService, semua anggota struktur WSAQUERYSET lainnya kecuali dwSize dan dwNameSpace diabaikan. Lihat Bluetooth dan BLOB untuk informasi selengkapnya. Mengirimkan rekaman SDP biner diperlukan dalam banyak kasus, karena sejumlah atribut SDP terbatas dapat dikonversi dari struktur WSAQUERYSET , dan string hanya dikonversi ke pengodean UTF-8 bahasa default. | Jika struktur BLOB dan BTH_SET_SERVICE opsional telah disediakan pada input, bersama dengan versi ULONG dan nilai HANDLE yang harus ditunjukkan oleh BTH_SET_SERVICE, versi diperbarui untuk berisi nilai BTH_SDP_VERSION untuk penyedia Bluetooth Windows Sockets, dan handel disediakan, yang diperlukan untuk kemudian menghapus rekaman. |
Catatan
Untuk menghapus layanan, satu-satunya anggota yang diperlukan dalam struktur BTH_SET_SERVICE adalah anggota pSdpVersion dan pRecordHandle.
Topik terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk