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 |
---|---|
|
In der Liste sind keine Elemente mehr vorhanden. Der Aufrufer sollte den Aufruf der BluetoothSdpGetContainerElementData-Funktion für diesen Container beenden. |
|
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 |