BluetoothSdpGetString-Funktion (bluetoothapis.h)

Artikel
08/22/2023

Die BluetoothSdpGetString-Funktion konvertiert eine unformatierte Zeichenfolge, die im SDP-Eintrag eingebettet ist, in eine Unicode-Zeichenfolge.

Syntax

DWORD BluetoothSdpGetString(
  [in]      LPBYTE                      pRecordStream,
  [in]      ULONG                       cbRecordLength,
  [in]      const PSDP_STRING_TYPE_DATA pStringData,
  [in]      USHORT                      usStringOffset,
  [out]     PWSTR                       pszString,
  [in, out] PULONG                      pcchStringLength
);

Parameter

[in] pRecordStream

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

[in] cbRecordLength

Die Länge von pRecordStream in Bytes.

[in] pStringData

Wenn sie auf NULL festgelegt ist, wird das aufrufende Threadgebietsschema verwendet, um nach einer übereinstimmenden Zeichenfolge im SDP-Datensatz zu suchen. Wenn nicht NULL, werden die Elemente mibeNum und attributeId der SDP_STRING_TYPE_DATA-Struktur verwendet, um die zu konvertierende Zeichenfolge zu finden.

[in] usStringOffset

Zu konvertierende SDP-Zeichenfolgentypoffset. Das usStringOffset wird dem Basisattributebezeichner der Zeichenfolge hinzugefügt. Durch die SDP-Spezifikation definierte Offsets sind: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET und STRING_PROVIDER_NAME_OFFSET. Diese Offsets finden Sie in der Headerdatei bthdef.h.

[out] pszString

Wenn nicht NULL, enthält die konvertierte Zeichenfolge bei der Ausgabe. Wenn sie auf NULL festgelegt ist, wird der parameter pcchStringLength mit der erforderlichen Anzahl von Zeichen und nicht mit Bytes gefüllt, um die konvertierte Zeichenfolge abzurufen.

[in, out] pcchStringLength

Enthält bei der Eingabe die Länge von pszString , wenn pszString nicht NULL ist, in Zeichen.

Enthält bei der Ausgabe die Anzahl der erforderlichen Zeichen, einschließlich NULL , wenn ein Fehler zurückgegeben wird, oder die Anzahl der Zeichen, die in pszString geschrieben wurden, einschließlich NULL.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. der pszString-Parameter enthält die konvertierte Zeichenfolge. Gibt fehlercodes zurück. Häufige Fehler sind in der folgenden Tabelle aufgeführt.

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Der pszString-Parameter war NULL oder zu klein, um die konvertierte Zeichenfolge zu enthalten. der parameter pcchStringLength enthält in Zeichen die erforderliche Länge.
ERROR_INVALID_DATA	Die Konvertierung kann nicht durchgeführt werden.
ERROR_NO_SYSTEM_RESOURCES	Das System kann nicht intern Arbeitsspeicher zuweisen, um die Konvertierung durchzuführen.
ERROR_INVALID_PARAMETER	Einer der erforderlichen Zeiger war NULL, der pRecordStream-Parameter war kein gültiger SDP-Stream, der pRecordStream war kein ordnungsgemäß formatierter Datensatz oder das angeforderte Attribut plus Offset war keine Zeichenfolge.

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

Weitere Informationen

BluetoothSdpEnumAttributes

BluetoothSdpGetAttributeValue

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA

Freigeben über