共用方式為


BTH_DEVICE_INFO 結構 (bthdef.h)

BTH_DEVICE_INFO結構會儲存藍牙裝置的相關信息。

語法

typedef struct _BTH_DEVICE_INFO {
  ULONG    flags;
  BTH_ADDR address;
  BTH_COD  classOfDevice;
  CHAR     name[BTH_MAX_NAME_SIZE];
} BTH_DEVICE_INFO, *PBTH_DEVICE_INFO;

成員

flags

下表所列一或多個旗標的組合。

意義
BDIF_ADDRESS
地址成員包含有效的數據。
BDIF_COD
classOfDevice 成員包含有效的數據。
BDIF_NAME
名稱成員包含有效的數據。
BDIF_PAIRED
裝置是已記住且已驗證的裝置。 設定此旗標時,一律會設定 BDIF_PERSONAL 旗標。
BDIF_PERSONAL
裝置是記住的裝置。 如果已設定此旗標 ,且未設定BDIF_PAIRED 旗標,則不會驗證裝置。
BDIF_CONNECTED
遠端藍牙裝置目前已連線到本機無線電。
BDIF_SSP_SUPPORTED
裝置支援使用安全簡單配對 (SSP) 。
BDIF_SSP_PAIRED
系統會記住裝置,並使用安全簡單配對 (SSP) 進行驗證。
BDIF_SSP_MITM_PROTECTED
裝置支援使用安全簡單配對 (SSP) ,以防止「中間人」攻擊。

address

遠端藍牙裝置的位址。

classOfDevice

位字段,描述遠端裝置 (COD) 裝置的裝置類別。 COD 包含下列四個字段:

格式:使用 GET_COD_FORMAT (classOfDevice) 擷取。 目前唯一支援的格式是COD_VERSION。

主要:使用 GET_COD_MAJOR (classOfDevice) 擷取。 目前已定義下列值,但列表預期會展開。 請勿使用主要類別欄位來判斷要連線的遠端裝置。 遠端裝置可能只有一個主要類別程式代碼,而且可能不是指定配置檔的適當程序代碼。

COD_MAJOR_MISCELLANEOUS

COD_MAJOR_COMPUTER

COD_MAJOR_PHONE

COD_MAJOR_LAN_ACCESS

COD_MAJOR_AUDIO

COD_MAJOR_PERIPHERAL

COD_MAJOR_IMAGING

COD_MAJOR_UNCLASSIFIED

次要:使用 GET_COD_MINOR (classOfDevice) 擷取。 次要程式代碼是每個主要程式代碼特有的,其定義其次要程式代碼的格式。 某些次要程式代碼是嚴格列舉的值;其他則是位欄位或位欄位欄位和列舉值的組合。

服務提示:使用 GET_COD_SERVICE (classOfDevice) 擷取。 提供遠端裝置功能的提示。

COD_SERVICE_LIMITED

COD_SERVICE_POSITIONING

COD_SERVICE_NETWORKING

COD_SERVICE_RENDERING

COD_SERVICE_CAPTURING

COD_SERVICE_OBJECT_XFER

COD_SERVICE_AUDIO

COD_SERVICE_TELEPHONY

COD_SERVICE_INFORMATION

name[BTH_MAX_NAME_SIZE]

遠端藍牙裝置的名稱,如裝置所報告,以 UTF8 編碼。 使用者可能已在本機提供遠端藍牙裝置的顯示名稱;該名稱被覆寫,而且不會出現在此成員中;它只能透過對 BluetoothGetDeviceInfo 函式的呼叫來存取。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
標頭 bthdef.h

另請參閱

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo