SdpCreateNodeString-Funktion (sdplib.h)

Die Bluetooth-Funktion SdpCreateNodeString wird verwendet, um eine SDP_NODE-Struktur einem Zeichenfolgentyp zuzuordnen und zu initialisieren.

Syntax

PSDP_NODE SdpCreateNodeString(
  [in] PCHAR string,
       ULONG stringLength,
  [in] ULONG tag
);

Parameter

[in] string

Ein Zeiger auf den Zeichenfolgenwert zum Initialisieren der SDP_NODE-Struktur.

stringLength

Ein ganzzahliger Wert ohne Vorzeichen, der die Länge der Zeichenfolge enthält.

[in] tag

Ein vom Profiltreiber definiertes Tag, das dem Knoten zugeordnet werden soll.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf die neu zugeordnete SDP_NODE-Struktur zurück. Wenn dies nicht erfolgreich ist, gibt diese Funktion NULL zurück.

Hinweise

Nachdem die SdpCreateNodeString-Funktion eine SDP_NODE-Struktur zugeordnet hat, initialisiert sie die -Struktur auf folgende Weise.

Dadurch wird sichergestellt, dass die Felder für den Datentyp und die Datengröße der SDP_NODE-Struktur entsprechend festgelegt sind.

Dadurch wird sichergestellt, dass die Zeigermember der zugeordneten SDP_NODE_HEADER-Struktur initialisiert werden, um auf den Knoten selbst zu verweisen. Dadurch wird eine gültige Liste mit nur einem Element erstellt.

Dadurch wird sichergestellt, dass der an die Funktion übergebene wertparameter in das entsprechende Element der SDP_NODE_DATA Union kopiert wird, das der SDP_NODE-Struktur zugeordnet ist.

Die der Funktion SdpCreateNodeString zugeordneten Daten werden in den Knoten kopiert, und die ursprünglichen Daten können jederzeit freigegeben werden.

Bluetooth-Profiltreiber können einen Zeiger auf diese Funktion über die BTHDDI_SDP_NODE_INTERFACE abrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Zielplattform	Desktop
Kopfzeile	sdplib.h (include BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL

Weitere Informationen

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER