BLUETOOTH_SELECT_DEVICE_PARAMS結構 (bluetoothapis.h)
BLUETOOTH_SELECT_DEVICE_PARAMS結構有助於和管理藍牙裝置和服務可見度、驗證及選取專案。
語法
typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
DWORD dwSize;
ULONG cNumOfClasses;
BLUETOOTH_COD_PAIRS *prgClassOfDevices;
LPWSTR pszInfo;
HWND hwndParent;
BOOL fForceAuthentication;
BOOL fShowAuthenticated;
BOOL fShowRemembered;
BOOL fShowUnknown;
BOOL fAddNewDeviceWizard;
BOOL fSkipServicesPage;
PFN_DEVICE_CALLBACK pfnDeviceCallback;
LPVOID pvParam;
DWORD cNumDevices;
PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;
成員
dwSize
BLUETOOTH_SELECT_DEVICE_PARAMS 結構的大小 ，以位元組為單位。
cNumOfClasses
prgClassOfDevices 中的類別數目。 設定為零以搜尋所有裝置。
prgClassOfDevices
要尋找的裝置類別陣列。
pszInfo
設定非 NULL 時的信息文字。
hwndParent
父視窗的句柄。 針對沒有父系，設定為 NULL 。
fForceAuthentication
如果 為 TRUE，則會在傳回之前強制驗證。
fShowAuthenticated
如果 為 TRUE，則會在選擇器中顯示已驗證的裝置。
fShowRemembered
如果 為 TRUE，則記住的裝置會顯示在選擇器中。
fShowUnknown
如果 為 TRUE，則會在選擇器中顯示未驗證或記住的未知裝置。
fAddNewDeviceWizard
如果 為TRUE，請啟動 [新增裝置精靈]。
fSkipServicesPage
如果 為 TRUE，則會略過 [新增裝置精靈] 中的 [服務] 頁面。
pfnDeviceCallback
針對每個裝置呼叫的回調函式指標。 如果回呼函式傳回 TRUE，則會新增專案。 如果回呼函式傳回 FALSE，則不會顯示專案。 若沒有回呼，請將 pfnDeviceCallback 設定為 null。 如需詳細資訊，請參閱 PFN_DEVICE_CALLBACK。
pvParam
要當做 pvParam 傳遞至 pfnDeviceCallback 中指向之回調函式的參數。
cNumDevices
在輸入時，指定所需的呼叫數目。 將 設定為零，沒有限制。 在輸出中，傳回傳回的裝置數目。
pDevices
BLUETOOTH_DEVICE_INFO 結構的陣列指標。
備註
若要釋放在 pDevices 成員中傳遞BLUETOOTH_DEVICE_INFO結構的數位，請呼叫 BluetoothSelectDevicesFree 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 標頭 | bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h) |