Функция InitializeUnicastIpAddressEntry (netioapi.h)
Функция 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 определена в Windows Vista и более поздних версиях.
Функция 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 |