SdpCreateNodeUrl-Funktion (sdplib.h)
Die -Funktion "Bluetooth SdpCreateNodeUrl" wird verwendet, um eine SDP_NODE Struktur einem URL-Typ zuzuweisen und zu initialisieren.
Syntax
PSDP_NODE SdpCreateNodeUrl(
[in] PCHAR url,
ULONG urlLength,
[in] ULONG tag
);
Parameter
[in] url
Ein Zeiger auf den URL-Wert, der zum Initialisieren der SDP_NODE-Struktur verwendet wird.
urlLength
Ein nicht signierter ganzzahliger Wert, der die Länge der URL 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 SdpCreateNodeUrl Funktion eine SDP_NODE Struktur zuordnet, initialisiert sie die Struktur auf folgende Weise.
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 SdpCreateNodeUrl zugeordneten Daten Funktion 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 Struktur.
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 |