Funzione DnsServiceConstructInstance (windns.h)

Articolo
03/13/2024

Usato per compilare una struttura DNS_SERVICE_INSTANCE dai dati che lo 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

Numero di proprietà: definisce il numero di elementi nelle matrici dei keys parametri 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 delle proprietà corrispondenti.

Valore restituito

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

Commenti

Il campo dwInterfaceIndex della struttura restituita è impostato su 0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	dnsapi.lib
DLL	dnsapi.dll

Condividi tramite