BluetoothSdpGetString-Funktion (bluetoothapis.h)
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 |
---|---|
|
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. |
|
Die Konvertierung kann nicht durchgeführt werden. |
|
Das System kann nicht intern Arbeitsspeicher zuweisen, um die Konvertierung durchzuführen. |
|
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 |