Функция DnsServiceConstructInstance (windns.h)

Статья
01/16/2025

Используется для создания структуры DNS_SERVICE_INSTANCE из данных, описывающих ее.

Синтаксис

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

Параметры

pServiceName

Строка, представляющая имя службы.

pHostName

Строка, представляющая имя узла службы.

pIp4

Указатель на структуру IP4_ADDRESS, представляющую связанный с службой IPv4-адрес.

pIp6

Указатель на IP6_ADDRESS структуру, представляющую связанный со службой IPv6-адрес.

wPort

Значение, представляющее порт, на котором выполняется служба.

wPriority

Значение, представляющее приоритет службы.

wWeight

Значение, представляющее вес службы.

dwPropertiesCount

Число свойств — определяет количество элементов в массивах параметров keys и values.

keys

Указатель на массив строковых значений, представляющих ключи свойств.

values

Указатель на массив строковых значений, представляющих соответствующие значения свойств.

Возвращаемое значение

Указатель на только что выделенную DNS_SERVICE_INSTANCE структуру, созданную из переданных параметров. Ваше приложение отвечает за освобождение связанной памяти путем вызова DnsServiceFreeInstance.

Замечания

Поле dwInterfaceIndex возвращаемой структуры имеет значение 0.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 [только классические приложения]
целевая платформа	Виндоус
заголовка	windns.h
библиотеки	dnsapi.lib
DLL	dnsapi.dll

Поделиться через