Función SdpCreateNodeString (sdplib.h)
La función Bluetooth SdpCreateNodeString se usa para asignar e inicializar una estructura de SDP_NODE a un tipo de cadena.
Sintaxis
PSDP_NODE SdpCreateNodeString(
[in] PCHAR string,
ULONG stringLength,
[in] ULONG tag
);
Parámetros
[in] string
Puntero al valor de cadena para inicializar la estructura SDP_NODE.
stringLength
Valor entero largo sin signo que contiene la longitud de la cadena.
[in] tag
Etiqueta definida por el controlador de perfil que se va a asociar al nodo.
Valor devuelto
Si se ejecuta correctamente, esta función devuelve un puntero a la estructura de SDP_NODE recién asignada. Si no se ejecuta correctamente, esta función devuelve NULL.
Comentarios
Después de que la función SdpCreateNodeString asigne una estructura de SDP_NODE , inicializa la estructura de las maneras siguientes.
Garantiza que el tipo de datos y los campos de tamaño de datos de la estructura de SDP_NODE se establezcan correctamente.
Garantiza que los miembros de puntero de la estructura de SDP_NODE_HEADER asociada se inicialicen para que apunten al propio nodo. Esto crea una lista válida con un solo elemento.
Garantiza que el parámetro de valor pasado a la función se copie en el elemento adecuado de la unión SDP_NODE_DATA asociada a la estructura SDP_NODE.
Los datos asociados a la función SdpCreateNodeString se copian en el nodo y los datos originales se pueden liberar en cualquier momento.
Los controladores de perfil bluetooth pueden obtener un puntero a esta función a través del BTHDDI_SDP_NODE_INTERFACE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Versions:_Supported en Windows Vista y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Encabezado | sdplib.h (incluya BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |