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 |