Compartilhar via


Função SdpCreateNodeUrl (sdplib.h)

A função Bluetooth SdpCreateNodeUrl é usada para alocar e inicializar uma estrutura SDP_NODE para um tipo de URL.

Sintaxe

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

Parâmetros

[in] url

Um ponteiro para o valor de URL usado para inicializar a estrutura SDP_NODE.

urlLength

Um valor inteiro longo sem sinal que contém o comprimento da URL.

[in] tag

Uma marca definida pelo driver de perfil a ser associada ao nó.

Retornar valor

Se tiver êxito, essa função retornará um ponteiro para a estrutura de SDP_NODE recém-alocada. Se não for bem-sucedida, essa função retornará NULL.

Comentários

Depois que a função SdpCreateNodeUrl aloca uma estrutura SDP_NODE , ela inicializa a estrutura das seguintes maneiras.

Ele garante que os campos de tipo de dados e tamanho de dados da estrutura SDP_NODE sejam definidos adequadamente.

Ele garante que os membros do ponteiro da estrutura de SDP_NODE_HEADER associada sejam inicializados para apontar para o próprio nó. Isso cria uma lista válida com apenas um elemento.

Ele garante que o parâmetro de valor passado para a função seja copiado para o elemento apropriado da união de SDP_NODE_DATA associada à estrutura SDP_NODE.

Os dados associados à função SdpCreateNodeUrl são copiados para o nó e os dados originais podem ser liberados a qualquer momento.

Os drivers de perfil Bluetooth podem obter um ponteiro para essa função por meio do BTHDDI_SDP_NODE_INTERFACE estrutura.

Requisitos

Requisito Valor
Cliente mínimo com suporte Versões:_Supported no Windows Vista e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho sdplib.h (inclua BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

Confira também

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER