Funzione SdpCreateNodeString (sdplib.h)

La 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 SDP_NODE struttura .

stringLength

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

[in] tag

Tag definito dal driver del profilo da associare al nodo.

Valore restituito

Se ha 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 ha allocato SDP_NODE struttura, inizializza la struttura nei modi seguenti.

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

Garantisce che i membri puntatore della struttura SDP_NODE_HEADER associata siano inizializzati in modo che puntino al nodo stesso. Verrà creato un elenco valido con un solo elemento.

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

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

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

Requisiti

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

Vedi anche

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER