BluetoothSdpEnumAttributes-Funktion (bluetoothapis.h)

Artikel
03/01/2024

Die BluetoothSdpEnumAttributes-Funktion listet den SDP-Datensatzdatenstrom auf und ruft die Rückruffunktion für jedes Attribut im Datensatz auf.

Syntax

BOOL BluetoothSdpEnumAttributes(
  LPBYTE                                 pSDPStream,
  ULONG                                  cbStreamSize,
  PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK pfnCallback,
  LPVOID                                 pvParam
);

Parameter

pSDPStream

Zeiger auf einen gültigen Datensatzdatenstrom, der als einzelner SDP-Datensatz formatiert ist.

cbStreamSize

Größe des Datenstroms, auf den pSDPStream in Bytes verweist.

pfnCallback

Zeiger auf die Rückrufroutine. Weitere Informationen zum Rückruf finden Sie unter PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK .

pvParam

Optionaler Parameter, der an die Rückrufroutine übergeben werden soll.

Rückgabewert

Gibt TRUE zurück, wenn eine Enumeration aufgetreten ist. Gibt FALSE zurück, wenn ein Fehler auftritt. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zu erhalten. In der folgenden Tabelle werden allgemeine Fehlercodes beschrieben, die der BluetoothSdpEnumAttributes-Funktion zugeordnet sind:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Der pSDPStream - oder pfnCallback-Parameter ist NULL.
ERROR_INVALID_DATA	Der SDP-Stream ist beschädigt.

Hinweise

Wenn die Rückruffunktion FALSE zurückgibt, wird die von der BluetoothSdpEnumAttributes-Funktion initiierte Enumeration beendet.

Der Datensatzdatenstrom in pSDPStream muss ein SDP-Stream sein, der als SDP-Eintrag formatiert ist, ein SEQUENCE-Paar mit Attribut-ID (UINT16) und Attributwert (beliebiger SDP-Elementtyp).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Bibliothek	Bthprops.lib
DLL	bthprops.cpl