DnsServiceConstructInstance, fonction (windns.h)

Article
03/04/2024

Permet de créer une structure de 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 s’exécute.

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 keys paramètres 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 retournée

Pointeur vers une structure de DNS_SERVICE_INSTANCE nouvellement allouée, générée à partir des paramètres passés. 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	windns.h
Bibliothèque	dnsapi.lib
DLL	dnsapi.dll

Partager via