BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur (bluetoothapis.h)
Die BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur erleichtert und verwaltet die Sichtbarkeit, Authentifizierung und Auswahl von Bluetooth-Geräten und -Diensten.
Syntax
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;
Member
dwSize
Größe der BLUETOOTH_SELECT_DEVICE_PARAMS Struktur in Bytes.
cNumOfClasses
Anzahl der Klassen in prgClassOfDevices. Legen Sie auf Null fest, um nach allen Geräten zu suchen.
prgClassOfDevices
Array der zu findenden Geräteklasse.
pszInfo
Legt den Informationstext fest, wenn nicht NULL.
hwndParent
Handle für das übergeordnete Fenster. Legen Sie für kein übergeordnetes Element auf NULL fest.
fForceAuthentication
Wenn TRUE, erzwingt die Authentifizierung vor der Rückgabe.
fShowAuthenticated
Wenn TRUE, werden authentifizierte Geräte in der Auswahl angezeigt.
fShowRemembered
Bei TRUE werden gespeicherte Geräte in der Auswahl angezeigt.
fShowUnknown
Wenn TRUE, werden unbekannte Geräte, die nicht authentifiziert oder nicht gespeichert sind, in der Auswahl angezeigt.
fAddNewDeviceWizard
Wenn TRUE, startet der Assistent Zum Hinzufügen eines neuen Geräts.
fSkipServicesPage
Wenn TRUE, überspringt die Seite Dienste im Assistenten Neues Gerät hinzufügen.
pfnDeviceCallback
Ein Zeiger auf eine Rückruffunktion, die für jedes Gerät aufgerufen wird. Wenn die Rückruffunktion TRUE zurückgibt, wird das Element hinzugefügt. Wenn die Rückruffunktion FALSE zurückgibt, wird das Element nicht angezeigt. Legen Sie pfnDeviceCallback für keinen Rückruf auf NULL fest. Weitere Informationen finden Sie unter PFN_DEVICE_CALLBACK.
pvParam
Parameter, der als pvParam an die Rückruffunktion übergeben werden soll, auf die in pfnDeviceCallback verwiesen wird.
cNumDevices
Gibt bei der Eingabe die Anzahl der gewünschten Aufrufe an. Legen Sie für kein Limit auf null fest. Gibt bei der Ausgabe die Anzahl der zurückgegebenen Geräte zurück.
pDevices
Zeiger auf ein Array von BLUETOOTH_DEVICE_INFO Strukturen.
Hinweise
Rufen Sie die BluetoothSelectDevicesFree-Funktion auf, um das Array von BLUETOOTH_DEVICE_INFO Strukturen frei zu machen, die im pDevices-Member übergeben wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h) |