Função SdpCreateNodeString (sdplib.h)

A função Bluetooth SdpCreateNodeString é usada para alocar e inicializar uma estrutura de SDP_NODE para um tipo de cadeia de caracteres.

Sintaxe

PSDP_NODE SdpCreateNodeString(
  [in] PCHAR string,
       ULONG stringLength,
  [in] ULONG tag
);

Parâmetros

[in] string

Um ponteiro para o valor da cadeia de caracteres para inicializar a estrutura de SDP_NODE.

stringLength

Um valor inteiro longo sem sinal que contém o comprimento da cadeia de caracteres.

[in] tag

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

Valor retornado

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 SdpCreateNodeString 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 de 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 nó em si. 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 de SDP_NODE.

Os dados associados à função SdpCreateNodeString 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.

Requisitos

   
Cliente mínimo com suporte Versões:_Supported no Windows Vista e posteriores.
Plataforma de Destino Desktop
Cabeçalho sdplib.h (include BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

Confira também

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER