Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
|
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 |