Funzione DnsServiceConstructInstance (windns.h)

Articolo
01/16/2025

Usato per compilare una struttura DNS_SERVICE_INSTANCE dai dati che la descrivono.

Sintassi

PDNS_SERVICE_INSTANCE DnsServiceConstructInstance(
  PCWSTR       pServiceName,
  PCWSTR       pHostName,
  PIP4_ADDRESS pIp4,
  PIP6_ADDRESS pIp6,
  WORD         wPort,
  WORD         wPriority,
  WORD         wWeight,
  DWORD        dwPropertiesCount,
  PCWSTR       *keys,
  PCWSTR       *values
);

Parametri

pServiceName

Stringa che rappresenta il nome del servizio.

pHostName

Stringa che rappresenta il nome dell'host del servizio.

pIp4

Puntatore a una struttura IP4_ADDRESS che rappresenta l'indirizzo IPv4 associato al servizio.

pIp6

Puntatore a una struttura IP6_ADDRESS che rappresenta l'indirizzo IPv6 associato al servizio.

wPort

Valore che rappresenta la porta in cui è in esecuzione il servizio.

wPriority

Valore che rappresenta la priorità del servizio.

wWeight

Valore che rappresenta il peso del servizio.

dwPropertiesCount

Il numero di proprietà, che definisce il numero di elementi nelle matrici dei parametri keys e values.

keys

Puntatore a una matrice di valori stringa che rappresentano le chiavi delle proprietà.

values

Puntatore a una matrice di valori stringa che rappresentano i valori della proprietà corrispondenti.

Valore restituito

Puntatore a una struttura DNS_SERVICE_INSTANCE appena allocata, compilata dai parametri passati. L'applicazione è responsabile della liberazione della memoria associata chiamando DnsServiceFreeInstance.

Osservazioni

Il campo dwInterfaceIndex della struttura restituita è impostato su 0.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windns.h
libreria	dnsapi.lib
dll	dnsapi.dll

Condividi tramite