DnsServiceConstructInstance-Funktion (windns.h)

Artikel
03/09/2024

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 dienstbezogene IPv4-Adresse darstellt.

pIp6

Ein Zeiger auf eine IP6_ADDRESS-Struktur , die die dienstbezogene IPv6-Adresse darstellt.

wPort

Ein Wert, der den Port darstellt, an 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 Parameter und values .

keys

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

values

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

Rückgabewert

Ein Zeiger auf eine neu zugewiesene DNS_SERVICE_INSTANCE-Struktur , die aus den übergebenen Parametern erstellt wird. Ihre Anwendung ist für das Freigeben des zugeordneten Arbeitsspeichers durch Aufrufen von DnsServiceFreeInstance verantwortlich.

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	windns.h
Bibliothek	dnsapi.lib
DLL	dnsapi.dll

Freigeben über