Compartir a través de

Función DnsServiceConstructInstance (windns.h)

  • Artículo

Se usa para crear una estructura de DNS_SERVICE_INSTANCE a partir de datos que la describen.

Sintaxis

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

Parámetros

pServiceName

Cadena que representa el nombre del servicio.

pHostName

Cadena que representa el nombre del host del servicio.

pIp4

Puntero a una estructura IP4_ADDRESS que representa la dirección IPv4 asociada al servicio.

pIp6

Puntero a una estructura de IP6_ADDRESS que representa la dirección IPv6 asociada al servicio.

wPort

Valor que representa el puerto en el que se ejecuta el servicio.

wPriority

Valor que representa la prioridad del servicio.

wWeight

Valor que representa el peso del servicio.

dwPropertiesCount

El número de propiedades: define el número de elementos de las matrices de los keys parámetros y values .

keys

Puntero a una matriz de valores de cadena que representan las claves de propiedad.

values

Puntero a una matriz de valores de cadena que representan los valores de propiedad correspondientes.

Valor devuelto

Puntero a una estructura de DNS_SERVICE_INSTANCE recién asignada, creada a partir de los parámetros pasados. La aplicación es responsable de liberar la memoria asociada llamando a DnsServiceFreeInstance.

Comentarios

El campo dwInterfaceIndex de la estructura devuelta se establece en 0.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado windns.h
Library dnsapi.lib
Archivo DLL dnsapi.dll