struktur SOCKADDR_BTH (ws2bth.h)

Struktur SOCKADDR_BTH digunakan bersama dengan operasi soket Bluetooth, yang ditentukan oleh keluarga alamat AF_BTH.

Sintaks

typedef struct _SOCKADDR_BTH {
  USHORT   addressFamily;
  BTH_ADDR btAddr;
  GUID     serviceClassId;
  ULONG    port;
} SOCKADDR_BTH, *PSOCKADDR_BTH;

Anggota

addressFamily

Keluarga alamat soket. Anggota ini selalu AF_BTH.

btAddr

Alamat perangkat Bluetooth target. Ketika digunakan dengan fungsi ikatan , harus nol atau alamat radio lokal yang valid. Jika nol, alamat perangkat Bluetooth lokal yang valid ditetapkan saat fungsi sambungkan atau terima dipanggil. Ketika digunakan dengan fungsi sambungkan , alamat radio jarak jauh yang valid harus ditentukan.

serviceClassId

Pengidentifikasi Kelas Layanan soket. Saat digunakan dengan fungsi ikat , serviceClassId diabaikan. Juga diabaikan jika port ditentukan. Untuk fungsi sambungkan , menentukan ID kelas layanan Bluetooth unik dari layanan yang ingin disambungkan. Jika perangkat serekan memiliki lebih dari satu port yang sesuai dengan pengidentifikasi kelas layanan, fungsi sambungkan mencoba terhubung ke layanan valid pertama; mekanisme ini dapat digunakan tanpa kueri SDP sebelumnya.

port

Saluran RFCOMM yang terkait dengan soket. Lihat Keterangan.

Keterangan

Ketika digunakan dengan fungsi ikatan pada aplikasi klien, anggota port harus nol untuk mengaktifkan titik akhir lokal yang sesuai untuk ditetapkan. Ketika digunakan dengan ikatan pada aplikasi server, anggota port harus berupa nomor port atau BT_PORT_ANY yang valid; port yang ditetapkan secara otomatis menggunakan BT_PORT_ANY dapat dikueri kemudian dengan panggilan ke fungsi getsockname . Rentang yang valid untuk meminta port RFCOMM tertentu adalah 1 hingga 30.

Saat menggunakan fungsi sambungkan ketika serviceClassId tidak disediakan, port harus langsung menentukan nomor port jarak jauh tempat operasi koneksi diminta. Menggunakan anggota port alih-alih anggota serviceClassId mengharuskan aplikasi untuk melakukan pencarian layanan (SDP) sendiri sebelum mencoba operasi sambungkan .

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 ikatan

Bluetooth dan getsockname

Bluetooth dan terima

Bluetooth dan sambungkan