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 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 |