BluetoothSdpGetAttributeValue-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothSdpGetAttributeValue-Funktion ruft den Attributwert für einen Attributbezeichner ab.

Syntax

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

Parameter

[in] pRecordStream

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

[in] cbRecordLength

Länge von pRecordStream in Bytes.

[in] usAttributeId

Attributbezeichner, nach dem gesucht werden soll. Siehe Hinweise.

[out] pAttributeData

Zeiger auf eine SDP_ELEMENT_DATA Struktur, in der der Bezeichnerwert des Attributs platziert wird.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. der pAddributeData-Parameter enthält den Attributwert. Jeder andere Rückgabewert gibt einen Fehler an. In der folgenden Tabelle werden allgemeine Fehlercodes beschrieben, die der BluetoothSdpGetAttributeValue-Funktion zugeordnet sind:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Entweder einer der erforderlichen Zeiger war NULL, der pRecordStream-Parameter war kein gültiger SDP-Stream oder der pRecordStream-Parameter war kein ordnungsgemäß formatierter SDP-Datensatz.
ERROR_FILE_NOT_FOUND	Der in usAttributeId angegebene Bezeichner wurde im Datensatz nicht gefunden.

Hinweise

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

Der im usAttributeId-Parameter bereitgestellte Attributbezeichner kann einer der vielen SDP_ATTRIB_Xxx universellen Attributbezeichner sein, die in der Datei bthdef.h bereitgestellt werden, oder ein benutzerdefinierter Attributwert, der durch ein Bluetooth-Profil definiert wird. Alle Werte, die größer als oder gleich 0x200 sind profilspezifische Attributbezeichner und für das Profil spezifisch. Eine Liste mit universellen SDP-Attributbezeichnern finden Sie in der Headerdatei bthdef.h.

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