Funzione SdpCreateNodeUrl (sdplib.h)

La funzione Bluetooth SdpCreateNodeUrl viene usata per allocare e inizializzare una struttura SDP_NODE a un tipo di URL.

Sintassi

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

Parametri

[in] url

Puntatore al valore URL utilizzato per inizializzare la struttura SDP_NODE.

urlLength

Valore intero long senza segno che contiene la lunghezza dell'URL.

[in] tag

Tag definito dal driver di profilo da associare al nodo.

Valore restituito

In caso di esito positivo, questa funzione restituisce un puntatore alla struttura SDP_NODE appena allocata. In caso contrario, questa funzione restituisce NULL.

Commenti

Dopo che la funzione SdpCreateNodeUrl alloca una struttura SDP_NODE , inizializza la struttura nei modi seguenti.

Garantisce che i campi del tipo di dati e delle dimensioni dei dati della struttura SDP_NODE siano impostati in modo appropriato.

Garantisce che i membri del puntatore della struttura di SDP_NODE_HEADER associata vengano inizializzati in modo da puntare al nodo stesso. Verrà creato un elenco valido con un solo elemento.

Garantisce che il parametro value passato alla funzione venga copiato nell'elemento appropriato dell'unione SDP_NODE_DATA associata alla struttura SDP_NODE.

I dati associati alla funzione SdpCreateNodeUrl vengono copiati nel nodo e i dati originali possono essere liberati in qualsiasi momento.

I driver del profilo Bluetooth possono ottenere un puntatore a questa funzione tramite il BTHDDI_SDP_NODE_INTERFACE struttura.

Requisiti

Vedi anche

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER