Функция InitializeUnicastIpAddressEntry (netioapi.h)

Статья
08/25/2023

Функция InitializeUnicastIpAddressEntry инициализирует структуру MIB_UNICASTIPADDRESS_ROW со значениями по умолчанию для одноадресной записи IP-адреса на локальном компьютере.

Синтаксис

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Параметры

[out] Row

В элементе — указатель на запись структуры MIB_UNICASTIPADDRESS_ROW для записи одноадресного IP-адреса. При возврате структура MIB_UNICASTIPADDRESS_ROW , на которую указывает этот параметр, инициализируется значениями по умолчанию для одноадресного IP-адреса.

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

Эта функция не возвращает значение.

Функция InitializeUnicastIpAddressEntry должна использоваться для инициализации элементов записи структуры MIB_UNICASTIPADDRESS_ROW со значениями по умолчанию для одноадресного IP-адреса для последующего использования с функцией CreateUnicastIpAddressEntry .

На входных данных InitializeUnicastIpAddressEntry необходимо передать новую структуру MIB_UNICASTIPADDRESS_ROW для инициализации.

В выходных данных элемент PrefixOriginструктуры MIB_UNICASTIPADDRESS_ROW , на которую указывает параметр Row , будет инициализирован в значение IpPrefixOriginUnchanged, элемент SuffixOrigin — ipSuffixOriginUnchanged, а элемент OnLinkPrefixLength — недопустимым значением. Кроме того, для элементов PreferredLifetime и ValidLifetime задано бесконечное значение, для элемента SkipAsSource установлено значение FALSE, а другие поля инициализируются равным нулю.

После вызова InitializeUnicastIpAddressEntry приложение может изменить элементы в записи MIB_UNICASTIPADDRESS_ROW , которую оно хочет изменить, а затем вызвать CreateUnicastIpAddressEntry , чтобы добавить новый одноадресный IP-адрес на локальный компьютер.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	netioapi.h (включая Iphlpapi.h)
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll