SdpCreateNodeString-Funktion (sdplib.h)
Die Bluetooth SdpCreateNodeString--Funktion wird verwendet, um eine SDP_NODE Struktur einem Zeichenfolgentyp zuzuweisen und zu initialisieren.
Syntax
PSDP_NODE SdpCreateNodeString(
[in] PCHAR string,
ULONG stringLength,
[in] ULONG tag
);
Parameter
[in] string
Ein Zeiger auf den Zeichenfolgenwert, um die SDP_NODE Struktur zu initialisieren.
stringLength
Ein nicht signierter ganzzahliger Wert, der die Länge der Zeichenfolge enthält.
[in] tag
Ein Profiltreiber, der 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 die Funktion nicht erfolgreich verläuft, wird NULL-zurückgegeben.
Bemerkungen
Nachdem die SdpCreateNodeString Funktion eine SDP_NODE Struktur zuweist, initialisiert sie die Struktur wie folgt.
Dadurch wird sichergestellt, dass die Datentyp- und Datengrößefelder der SDP_NODE Struktur entsprechend festgelegt werden.
Dadurch wird sichergestellt, dass die Zeigerm 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.
Es stellt sicher, dass der Wert Parameter, der an die Funktion übergeben wird, in das entsprechende Element der SDP_NODE_DATA Union kopiert wird, die der SDP_NODE Struktur zugeordnet ist.
Die dem SdpCreateNodeString Funktion zugeordneten Daten werden in den Knoten kopiert, und die ursprünglichen Daten können jederzeit freigegeben werden.
Bluetooth-Profiltreiber können über die BTHDDI_SDP_NODE_INTERFACEeinen Zeiger auf diese Funktion abrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows Vista und höher. |
| Zielplattform- | Desktop |
| Header- | sdplib.h (include BthSdpddi.h) |
| IRQL- | <= PASSIVE_LEVEL |