SdpCreateNodeUrl, fonction (sdplib.h)

La fonction bluetooth SdpCreateNodeUrl est utilisée pour allouer et initialiser une structure SDP_NODE à un type d’URL.

Syntaxe

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

Paramètres

[in] url

Pointeur vers la valeur d’URL utilisée pour initialiser la structure SDP_NODE.

urlLength

Valeur entière longue non signée qui contient la longueur de l’URL.

[in] tag

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

Valeur de retour

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

Remarques

Une fois que la fonction SdpCreateNodeUrl 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 définis de manière appropriée.

Il garantit que les membres du pointeur de la structure de 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.

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

Les données associées à la fonction SdpCreateNodeUrl 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 structure BTHDDI_SDP_NODE_INTERFACE.

Exigences

Voir aussi

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER