Compartir a través de


Función SdpCreateNodeUrl (sdplib.h)

La función Bluetooth SdpCreateNodeUrl se usa para asignar e inicializar una estructura de SDP_NODE a un tipo de dirección URL.

Sintaxis

PSDP_NODE SdpCreateNodeUrl(
  [in] PCHAR url,
       ULONG urlLength,
  [in] ULONG tag
);

Parámetros

[in] url

Puntero al valor de dirección URL que se usa para inicializar la estructura de SDP_NODE.

urlLength

Valor entero largo sin signo que contiene la longitud de la dirección URL.

[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 SdpCreateNodeUrl asigne una estructura SDP_NODE , inicializa la estructura de las maneras siguientes.

Garantiza que el tipo de datos de la estructura SDP_NODE y los campos de tamaño de datos se establezcan correctamente.

Garantiza que los miembros del 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 value 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 SdpCreateNodeUrl 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 de BTHDDI_SDP_NODE_INTERFACE estructura.

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

Consulte también

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER