BluetoothSdpGetContainerElementData-Funktion (bluetoothapis.h)

Die BluetoothSdpGetContainerElementData-Funktion durchläuft einen Containerstream und gibt jedes im Containerelement enthaltene Element zurück.

Syntax

DWORD BluetoothSdpGetContainerElementData(
  [in]      LPBYTE                       pContainerStream,
  [in]      ULONG                        cbContainerLength,
  [in, out] HBLUETOOTH_CONTAINER_ELEMENT *pElement,
  [out]     PSDP_ELEMENT_DATA            pData
);

Parameter

[in] pContainerStream

Ein Zeiger auf einen gültigen SDP-Stream. Das erste Element im Stream muss eine Sequenz oder eine Alternative sein.

[in] cbContainerLength

Die Größe des pContainerStream-Parameters in Bytes.

[in, out] pElement

Ein Wert, der zum Nachverfolgen des Speicherorts im Stream verwendet wird. Wenn die BluetoothSdpGetContainerElementData-Funktion zum ersten Mal für einen Container aufgerufen wird, sollte *pElementNULL sein. Bei nachfolgenden Aufrufen sollte der Wert unverändert sein.

[out] pData

Ein Zeiger auf einen Puffer, der mit Daten aus dem aktuellen SDP-Element von pContainerStream gefüllt ist.

Rückgabewert

Gibt bei Erfolg ERROR_SUCCESS zurück, was angibt, dass der pData-Parameter die Daten enthält. Gibt Fehlercodes bei Einem Fehler zurück. In der folgenden Tabelle werden allgemeine Fehlercodes beschrieben, die der BluetoothSdpGetContainerElementData-Funktion zugeordnet sind:

Rückgabecode	Beschreibung
ERROR_NO_MORE_ITEMS	In der Liste sind keine Elemente mehr vorhanden. Der Aufrufer sollte den Aufruf der BluetoothSdpGetContainerElementData-Funktion für diesen Container beenden.
ERROR_INVALID_PARAMETER	Ein erforderlicher Zeiger ist NULL, oder der Container ist kein gültiger SDP-Stream.

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

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA