// sdplib.h
PSDP_NODE SdpCreateNodeUrl(
[in] PCHAR url,
ULONG urlLength,
[in] ULONG tag
);
View the official Windows Driver Kit DDI referenceNo description available.
The Bluetooth SdpCreateNodeUrl function is used to allocate and initialize an SDP_NODE structure to a URL type.
url [in]A pointer to the URL value that is used to initialize the SDP_NODE structure.
urlLengthAn unsigned long integer value that holds the length of the URL.
tag [in]A profile driver defined tag to associate with the node.
If successful, this function returns a pointer to the newly allocated SDP_NODE structure. If not successful, this function returns NULL.
After the SdpCreateNodeUrl function allocates an SDP_NODE structure, it initializes the structure in the following ways.
It ensures that the SDP_NODE structure's data type and data size fields are set appropriately.
It ensures that the pointer members of the associated SDP_NODE_HEADER structure are initialized to point to the node itself. This creates a valid list with only one element.
It ensures that the value parameter passed to the function is copied to the appropriate element of the SDP_NODE_DATA union that is associated with the SDP_NODE structure.
The data associated with the SdpCreateNodeUrl function is copied into the node, and the original data can be freed at any time.
Bluetooth profile drivers can obtain a pointer to this function through the BTHDDI_SDP_NODE_INTERFACE structure.