Funzione SdpCreateNodeString (sdplib.h)

  • Articolo

La funzione Bluetooth SdpCreateNodeString viene usata per allocare e inizializzare una struttura SDP_NODE a un tipo stringa.

Sintassi

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

Parametri

[in] string

Puntatore al valore stringa per inizializzare la struttura SDP_NODE.

stringLength

Valore long integer senza segno che contiene la lunghezza della stringa.

[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 SdpCreateNodeString 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 SdpCreateNodeString 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.

Requisiti

Requisito Valore
Client minimo supportato Versioni:_Supported in Windows Vista e versioni successive.
Piattaforma di destinazione Desktop
Intestazione sdplib.h (include BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

Vedi anche

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER