BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur (bluetoothapis.h)

Artikel
08/22/2023

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)

Weitere Informationen

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectGeräte

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK

Share via