Función SdpCreateNodeUrl (sdplib.h)
La función SdpCreateNodeUrl de Bluetooth 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 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.
Observaciones
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 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 valor parámetro pasado a la función se copia 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 de Bluetooth pueden obtener un puntero a esta función a través de BTHDDI_SDP_NODE_INTERFACE estructura.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Versiones: _Supported en Windows Vista y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| encabezado de | sdplib.h (incluya BthSdpddi.h) |
| irQL | <= PASSIVE_LEVEL |