BLUETOOTH_SELECT_DEVICE_PARAMS構造 (bluetoothapis.h)
BLUETOOTH_SELECT_DEVICE_PARAMS構造により、Bluetooth デバイスとサービスの可視性、認証、選択が容易になり、管理されます。
構文
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 内のクラスの数。 すべてのデバイスを検索するには、0 に設定します。
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
pfnDeviceCallback で指されるコールバック関数に pvParam として渡されるパラメーター。
cNumDevices
入力時に、目的の呼び出しの数を指定します。 制限がない場合は 0 に設定します。 出力時に、 は返されるデバイスの数を返します。
pDevices
BLUETOOTH_DEVICE_INFO構造体の配列へのポインター。
注釈
pDevices メンバーで渡されたBLUETOOTH_DEVICE_INFO構造体の配列を解放するには、BluetoothSelectDevicesFree 関数を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| Header | bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む) |