Функция DeleteProxyArpEntry (iphlpapi.h)

Статья
08/24/2023

Функция DeleteProxyArpEntry удаляет запись PARP на локальном компьютере, указанном параметрами dwAddress и dwIfIndex .

Синтаксис

IPHLPAPI_DLL_LINKAGE DWORD DeleteProxyArpEntry(
  [in] DWORD dwAddress,
  [in] DWORD dwMask,
  [in] DWORD dwIfIndex
);

Параметры

[in] dwAddress

IPv4-адрес, для которого этот компьютер выступает в качестве прокси-сервера.

[in] dwMask

Маска подсети для IPv4-адреса, указанного в параметре dwAddress .

[in] dwIfIndex

Индекс интерфейса, на котором этот компьютер поддерживает прокси-сервер ARP для IP-адреса, указанного параметром dwAddress .

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

Функция возвращает NO_ERROR (ноль), если функция выполнена успешно.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Код возврата	Описание
ERROR_ACCESS_DENIED	Отказано в доступе". Эта ошибка возвращается в Windows Vista и Windows Server 2008 при следующих условиях: у пользователя отсутствуют необходимые права администратора на локальном компьютере или приложение не работает в расширенной оболочке в качестве встроенного администратора (администратор запуска от имени).
ERROR_INVALID_PARAMETER	Входной параметр недопустим, никаких действий не предпринималось.
ERROR_NOT_SUPPORTED	Транспорт IPv4 не настроен на локальном компьютере.
Другое	Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

В Windows Vista и более поздних версиях функция DeleteProxyArpEntry может вызываться только пользователем, вошедшего в систему как участник группы Администраторы. Если метод DeleteProxyArpEntry вызывается пользователем, не включаемым в группу Администраторы, вызов функции завершится ошибкой и ERROR_ACCESS_DENIED возвращается. Эта функция также может завершиться ошибкой из-за контроля учетных записей (UAC) в Windows Vista и более поздних версиях. Если приложение, содержащее эту функцию, выполняется пользователем, вошедшего в систему как участник группы администраторов, отличный от встроенного администратора, этот вызов завершится ошибкой, если приложение не было отмечено в файле манифеста параметром requestedExecutionLevel , для которого задано значение requireAdministrator. Если в приложении в Windows Vista и более поздних версиях отсутствует этот файл манифеста, пользователь, вошедший в систему как участник группы администраторов, отличный от встроенного администратора, должен затем выполнять приложение в расширенной оболочке в качестве встроенного администратора (администратора запуска от имени) для успешного выполнения этой функции.

Примечание Эта функция выполняет привилегированную операцию. Для успешного выполнения этой функции вызывающий объект должен войти в систему как член группы Администраторы или NetworkConfigurationOperators.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	iphlpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll