Функция DeleteAnycastIpAddressEntry
Функция deleteAnycastIpAddressEntry удаляет существующую запись IP-адреса любой рассылки на локальном компьютере.
Синтаксис
NETIOAPI_API DeleteAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Параметры
-
строк [in]
Указатель на запись структуры MIB_ANYCASTIPADDRESS_ROW для существующей записи IP-адреса любой рассылки для удаления с локального компьютера.
Возвращаемое значение
DeleteAnycastIpAddressEntry возвращает STATUS_SUCCESS, если функция выполнена успешно.
Если функция завершается ошибкой, DeleteAnycastIpAddressEntry возвращает один из следующих кодов ошибок:
| Возвращаемый код | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | Недопустимый параметр был передан функции. Эта ошибка возвращается, если указатель NULL передается в параметре row, Элемент адреса структуры MIB_ANYCASTIPADDRESS_ROW, на который указывает параметр Row, не задан допустимый одноадресный IPv4 или IPv6-адрес или InterfaceLuid и InterfaceIndex члены структуры MIB_ANYCASTIPADDRESS_ROW были не указаны. |
| STATUS_NOT_FOUND | Не удалось найти указанный интерфейс. Эта ошибка возвращается, если функция не может найти сетевой интерфейс, указанный interfaceLuidили interfaceIndex член структуры MIB_ANYCASTIPADDRESS_ROW, на которую указывает параметр строки. |
| STATUS_NOT_SUPPORTED | Запрос не поддерживается. Эта ошибка возвращается, если на локальном компьютере не находится стек IPv4, а адрес IPv4 был указан в элементе адреса MIB_ANYCASTIPADDRESS_ROW, на который указывает параметр строка, или если на локальном компьютере не указан стек IPv6, а адрес IPv6 указан в элементе адрес. |
| Другие | Используйте функцию FormatMessage, чтобы получить строку сообщения для возвращаемой ошибки. |
Замечания
Функция DeleteAnycastIpAddressEntry используется для удаления существующей записи структуры MIB_ANYCASTIPADDRESS_ROW на локальном компьютере.
При входе драйвер должен инициализировать следующие члены структуры MIB_ANYCASTIPADDRESS_ROW, на которые указывает параметр строка.
адрес
Задайте допустимый ip-адрес и семейство одноадресной рассылки IPv4 или IPv6.InterfaceLuid или InterfaceIn dex
Эти члены используются в порядке, указанном ранее. Поэтому если указан InterfaceLuid, этот элемент используется для определения интерфейса. Если для элемента InterfaceLuid не задано значение (значение этого элемента было равно нулю), элемент InterfaceIndex используется для определения интерфейса.
Если функция выполнена успешно, был удален существующий IP-адрес, который был удален параметром row.
Драйвер может вызвать функцию GetAnycastIpAddressTable для перечисления записей IP-адресов любой рассылки на локальном компьютере. Драйвер может вызвать функцию GetAnycastIpAddressEntry для получения определенной существующей записи IP-адреса любой рассылки.