Partager via


SdpCreateNodeString, fonction (sdplib.h)

La fonction Bluetooth SdpCreateNodeString est utilisée pour allouer et initialiser une structure SDP_NODE à un type de chaîne.

Syntaxe

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

Paramètres

[in] string

Pointeur vers la valeur de chaîne pour initialiser la structure SDP_NODE.

stringLength

Valeur entière longue non signée qui contient la longueur de la chaîne.

[in] tag

Balise définie par le pilote de profil à associer au nœud.

Valeur retournée

Si elle réussit, cette fonction retourne un pointeur vers la structure SDP_NODE nouvellement allouée. Si elle échoue, cette fonction retourne NULL.

Remarques

Une fois que la fonction SdpCreateNodeString alloue une structure SDP_NODE , elle initialise la structure de la manière suivante.

Il garantit que le type de données et les champs de taille de données de la structure SDP_NODE sont correctement définis.

Il garantit que les membres pointeurs de la structure SDP_NODE_HEADER associée sont initialisés pour pointer vers le nœud lui-même. Cela crée une liste valide avec un seul élément.

Elle garantit que le paramètre value passé à la fonction est copié dans l’élément approprié de l’union SDP_NODE_DATA qui est associée à la structure SDP_NODE.

Les données associées à la fonction SdpCreateNodeString sont copiées dans le nœud et les données d’origine peuvent être libérées à tout moment.

Les pilotes de profil Bluetooth peuvent obtenir un pointeur vers cette fonction via le BTHDDI_SDP_NODE_INTERFACE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Versions :_Supported dans Windows Vista et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
En-tête sdplib.h (inclure BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

Voir aussi

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER