DnsServiceConstructInstance-Funktion (windns.h)

Wird verwendet, um eine DNS_SERVICE_INSTANCE Struktur aus Daten zu erstellen, die sie beschreiben.

Syntax

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

Parameter

pServiceName

Eine Zeichenfolge, die den Namen des Diensts darstellt.

pHostName

Eine Zeichenfolge, die den Namen des Hosts des Diensts darstellt.

pIp4

Ein Zeiger auf eine IP4_ADDRESS-Struktur, die die vom Dienst zugeordnete IPv4-Adresse darstellt.

pIp6

Ein Zeiger auf eine IP6_ADDRESS-Struktur, die die vom Dienst zugeordnete IPv6-Adresse darstellt.

wPort

Ein Wert, der den Port darstellt, auf dem der Dienst ausgeführt wird.

wPriority

Ein Wert, der die Dienstpriorität darstellt.

wWeight

Ein Wert, der die Dienstgewichtung darstellt.

dwPropertiesCount

Die Anzahl der Eigenschaften – definiert die Anzahl der Elemente in den Arrays der keys und values Parameter.

keys

Ein Zeiger auf ein Array von Zeichenfolgenwerten, die die Eigenschaftsschlüssel darstellen.

values

Ein Zeiger auf ein Array von Zeichenfolgenwerten, die die entsprechenden Eigenschaftswerte darstellen.

Rückgabewert

Ein Zeiger auf eine neu zugeordnete DNS_SERVICE_INSTANCE Struktur, die aus den übergebenen Parametern erstellt wurde. Ihre Anwendung ist dafür verantwortlich, den zugeordneten Speicher freizugeben, indem DnsServiceFreeInstanceaufgerufen wird.

Bemerkungen

Das dwInterfaceIndex- Feld der zurückgegebenen Struktur ist auf 0 festgelegt.

Anforderungen