Функция InitializeUnicastIpAddressEntry
Функция InitializeUnicastIpAddressEntry инициализирует структуру MIB_UNICASTIPADDRESS_ROW со значениями по умолчанию для одноадресной записи IP-адреса на локальном компьютере.
Синтаксис
VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
_Out_ PMIB_UNICASTIPADDRESS_ROW Row
);
Параметры
- Строка [out]
В элементе — указатель на запись структуры MIB_UNICASTIPADDRESS_ROW для записи одноадресного IP-адреса. При возврате структура MIB_UNICASTIPADDRESS_ROW, на которую указывает этот параметр, инициализируется значениями по умолчанию для одноадресного IP-адреса.
Возвращаемое значение
None
Remarks
Драйвер должен использовать функцию InitializeUnicastIpAddressEntry для инициализации членов записи структуры MIB_UNICASTIPADDRESS_ROW со значениями по умолчанию для одноадресного IP-адреса для последующего использования с функцией CreateUnicastIpAddressEntry .
При входе драйвер должен передать InitializeUnicastIpAddressEntry новую структуру MIB_UNICASTIPADDRESS_ROW для инициализации.
В выходных данных элементы структуры MIB_UNICASTIPADDRESS_ROW, на которую указывает параметр Row , инициализируются следующим образом.
ПрефиксOrigin
Задайте значение IpPrefixOriginUnchanged перечисления NL_PREFIX_ORIGIN .СуффиксOrigin
Задайте значение IpSuffixOriginUnchanged перечисления NL_PREFIX_ORIGIN .OnLinkPrefixLength
Задайте недопустимое значение.PreferredLifetime и ValidLifetime
Задайте для параметра бесконечные значения.SkipAsSource
Установите значение FALSE.Все остальные члены
Задайте нулевое значение.
После вызова драйвером InitializeUnicastIpAddressEntry драйвер может изменить элементы в записи MIB_UNICASTIPADDRESS_ROW, которую он хочет изменить, а затем вызвать CreateUnicastIpAddressEntry , чтобы добавить новый одноадресный IP-адрес на локальный компьютер.
Требования
Целевая платформа |
Универсальное |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (включая Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |