Funzione SdpCreateNodeString (sdplib.h)
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 intero long senza segno che contiene la lunghezza della stringa.
[in] tag
Tag definito dal driver del 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 di esito negativo, questa funzione restituisce NULL.
Osservazioni
Dopo che la funzione di 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 di SDP_NODE siano impostati in modo appropriato.
Garantisce che i membri del puntatore della struttura di SDP_NODE_HEADER associata vengano inizializzati in modo che puntino al nodo stesso. Verrà creato un elenco valido con un solo elemento.
Garantisce che il valore parametro 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.
Fabbisogno
| 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 |