struktur BTH_SET_SERVICE (ws2bth.h)

Artikel
08/28/2023

Struktur BTH_SET_SERVICE menyediakan informasi layanan untuk layanan Bluetooth yang ditentukan.

Sintaks

typedef struct _BTH_SET_SERVICE {
  PULONG pSdpVersion;
  HANDLE *pRecordHandle;
  ULONG  fCodService;
  ULONG  Reserved[5];
  ULONG  ulRecordLength;
  UCHAR  pRecord[1];
} BTH_SET_SERVICE, *PBTH_SET_SERVICE, BTHNS_SETBLOB, *PBTHNS_SETBLOB;

Anggota

pSdpVersion

Versi SDP. Klien mengatur anggota ini ke BTH_SDP_VERSION.

pRecordHandle

Tangani ke catatan SDP. Sesuai dengan SDP ServiceRecordHandle. Dikembalikan oleh operasi tambahkan rekaman, dan kemudian digunakan untuk menghapus rekaman.

fCodService

Informasi Kelas perangkat (COD). Bidang 32-bit dari kelas COD_SERVICE_* bit perangkat yang terkait dengan catatan SDP ini. Sistem menggabungkan bit ini dengan bit COD dari rekaman layanan lain dan karakteristik sistem. Kelas perangkat yang dihasilkan untuk radio lokal diiklankan ketika radio ditemukan selama pertanyaan perangkat. Ketika catatan SDP terakhir yang terkait dengan bit layanan tertentu dihapus, bit layanan tersebut tidak lagi dilaporkan sebagai respons terhadap pertanyaan perangkat di masa mendatang.

Format dan nilai yang mungkin untuk bidang COD ditentukan dalam bagian Bluetooth Assigned Numbers 1.1 dari spesifikasi Bluetooth, Bagian 1.2. (Sumber daya ini mungkin tidak tersedia di beberapa bahasa dan negara.) Makro dan definisi yang sesuai untuk bit COD_SERVICE_* yang digunakan oleh Windows ditentukan dalam Bthdef.h. Untuk informasi selengkapnya tentang kelas perangkat (COD), lihat BTH_DEVICE_INFO.

Reserved[5]

Dicadangkan. Harus diatur ke nol.

ulRecordLength

Ukuran, dalam byte, dari pRecord.

pRecord[1]

Catatan SDP, sebagaimana didefinisikan oleh spesifikasi Bluetooth.

Keterangan

Saat menggunakan struktur BTH_SET_SERVICE untuk mengkueri layanan dan perangkat menggunakan fungsi WSASetService dan struktur WSAQUERYSET dan BLOB . Nilai berikut untuk anggota BTH_SET_SERVICE harus digunakan.

Untuk informasi selengkapnya tentang kelas perangkat (COD), lihat spesifikasi Bluetooth di www.bluetooth.com.

Anggota	Nilai yang diperlukan
pSdpVersion	Penunjuk ke versi ULONG, yang diubah setiap kali format biner rekaman SDP berubah, memengaruhi format anggota pRecord . Atur ke BTH_SDP_VERSION untuk klien, dan dikembalikan oleh sistem.
pRecordHandle	Menangani catatan SDP; sesuai dengan SDP ServiceRecordHandle. Dikembalikan oleh operasi tambahkan rekaman, dan kemudian digunakan untuk menghapus rekaman.
fOptions	Atribut yang ditentukan oleh BTHNS_SET_FLAGS.
ulRecordLength	Panjang, dalam byte, dari catatan SDP biner yang ditujukkan oleh pRecord.
pRecord	Penunjuk ke rekaman SDP yang valid, dalam format yang ditentukan oleh spesifikasi Bluetooth.

Anggota pRecordHandle harus menunjuk ke data yang null untuk pendaftaran layanan baru. Untuk penghapusan layanan, pRecordHandle harus menunjuk ke handel yang valid. Anggota pRecord harus berisi seluruh catatan layanan SD, seperti yang dijelaskan dalam spesifikasi Bluetooth. Untuk entri protokol RFCOMM, nomor port sama dengan port yang dikembalikan oleh panggilan fungsi getsockname .

Bluetooth mengimplementasikan korelasi satu-ke-satu antara rekaman SDP dan soket server. Dengan demikian, tidak perlu bendera SERVICE_MULTIPLE .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Header	ws2bth.h

Lihat juga

Bluetooth dan getsockname

Bluetooth dan BLOB

Bluetooth dan WSASetService

WSAQUERYSET

Bagikan melalui