Função SdpCreateNodeString (sdplib.h)
A função SdpCreateNodeString Bluetooth é 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 de retorno
Se bem-sucedida, essa função retornará um ponteiro para a estrutura de SDP_NODE recém-alocada. Se não tiver êxito, essa função retornará NULL.
Observações
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 valor parâmetro passado para a função seja copiado para o elemento apropriado da união SDP_NODE_DATA associada à estrutura 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
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Versões:_Supported no Windows Vista e posterior. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |