DnsServiceConstructInstance, fonction (windns.h)

Article
01/16/2025

Utilisé pour générer une structure DNS_SERVICE_INSTANCE à partir de données qui la décrivent.

Syntaxe

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

Paramètres

pServiceName

Chaîne qui représente le nom du service.

pHostName

Chaîne qui représente le nom de l’hôte du service.

pIp4

Pointeur vers une structure IP4_ADDRESS qui représente l’adresse IPv4 associée au service.

pIp6

Pointeur vers une structure IP6_ADDRESS qui représente l’adresse IPv6 associée au service.

wPort

Valeur qui représente le port sur lequel le service est en cours d’exécution.

wPriority

Valeur qui représente la priorité du service.

wWeight

Valeur qui représente le poids du service.

dwPropertiesCount

Nombre de propriétés : définit le nombre d’éléments dans les tableaux des paramètres keys et values.

keys

Pointeur vers un tableau de valeurs de chaîne qui représentent les clés de propriété.

values

Pointeur vers un tableau de valeurs de chaîne qui représentent les valeurs de propriété correspondantes.

Valeur de retour

Pointeur vers une structure de DNS_SERVICE_INSTANCE nouvellement allouée, générée à partir des paramètres transmis. Votre application est chargée de libérer la mémoire associée en appelant DnsServiceFreeInstance.

Remarques

Le champ dwInterfaceIndex de la structure retournée est défini sur 0.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	windns.h
bibliothèque	dnsapi.lib
DLL	dnsapi.dll

Partager via