Функция InitializeUnicastIpAddressEntry

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

Синтаксис

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Параметры

• строка [out]
  При входе указатель на запись MIB_UNICASTIPADDRESS_ROW структуры для записи одноадресного IP-адреса. При возврате структура MIB_UNICASTIPADDRESS_ROW, на которую указывает этот параметр, инициализирована значениями по умолчанию для ip-адреса одноадресной рассылки.

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

Никакой

Замечания

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

При входе драйвер должен передать InitializeUnicastIpAddressEntry новую структуру MIB_UNICASTIPADDRESS_ROW для инициализации.

В выходных данных члены структуры MIB_UNICASTIPADDRESS_ROW, на которые указывает параметр строка, инициализированы следующим образом.

• ПрефиксOrigin
  Задайте значение IpPrefixOriginUnchanged перечисления NL_PREFIX_ORIGIN.

• СуффиксОригин
  Задайте значение IpSuffixOriginUnchanged перечисления NL_PREFIX_ORIGIN.

• OnLinkPrefixLength
  Задайте для недопустимого значения.

• PreferredLifetime и ValidLifetime
  Задайте для бесконечных значений.

• SkipAsSource
  Установите значение FALSE.

• Все остальные члены
  Установите значение нулю.

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

Требования

Целевая платформа	универсальные
Версия	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Заголовок	Netioapi.h (include Netioapi.h)
Библиотека	Netio.lib
IRQL	< DISPATCH_LEVEL

См. также

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry