SOCKADDR_BTH結構 (ws2bth.h)

發行項
03/04/2024

SOCKADDR_BTH結構會與由位址系列AF_BTH定義的藍牙套接字作業搭配使用。

語法

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

成員

addressFamily

套接字的位址系列。這個成員一律AF_BTH。

btAddr

目標藍牙裝置的位址。與 bind 函式搭配使用時，必須是零或有效的本機單選位址。如果為零，則會在呼叫連線或 accept 函式時指派有效的本機藍牙裝置位址。搭配 connect 函式使用時，必須指定有效的遠端無線電位址。

serviceClassId

套接字的服務類別識別碼。與 bind 函式搭配使用時，會忽略 serviceClassId 。如果指定了埠，也會忽略此埠。針對 connect 函式，指定它想要連線之服務的唯一藍牙服務類別標識碼。如果對等裝置有多個對應至服務類別標識符的埠， 則 connect 函式會嘗試連線到第一個有效的服務;這個機制可以在沒有先前的 SDP 查詢的情況下使用。

port

與套接字相關聯的 RFCOMM 通道。請參閱＜備註＞。

備註

搭配用戶端應用程式上的 bind 函式使用時，埠成員必須為零，才能指派適當的本機端點。搭配伺服器應用程式上的系結使用時，埠成員必須是有效的埠號碼或BT_PORT_ANY;後續可能會透過呼叫 getsockname 函式，查詢使用BT_PORT_ANY自動指派的埠。要求特定 RFCOMM 埠的有效範圍是 1 到 30。

未提供 serviceClassId 時使用 connect 函式時，埠應該直接指定要求連接作業的遠端埠號碼。使用埠成員而非 serviceClassId 成員，需要應用程式在嘗試連線作業之前，先執行自己的服務 (SDP) 搜尋。