Функция SetIpNetEntry (iphlpapi.h)
Функция SetIpNetEntry изменяет существующую запись ARP в таблице ARP на локальном компьютере.
Синтаксис
IPHLPAPI_DLL_LINKAGE DWORD SetIpNetEntry(
[in] PMIB_IPNETROW pArpEntry
);
Параметры
[in] pArpEntry
Указатель на структуру MIB_IPNETROW . Сведения в этой структуре указывают запись для изменения и новые сведения для записи. Вызывающий объект должен указать значения для всех членов этой структуры.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
Код возврата | Описание |
---|---|
|
Отказано в доступе". Эта ошибка возвращается в Windows Vista и Windows Server 2008 при следующих условиях: у пользователя отсутствуют необходимые права администратора на локальном компьютере или приложение не работает в расширенной оболочке в качестве встроенного администратора (администратор запуска от имени). |
|
Параметр pArpEntry имеет значение NULL, или SetIpNetEntry не может считывать данные из памяти, на которую указывает pArpEntry, или один из элементов структуры MIB_IPNETROW является недопустимым. |
|
Транспорт IPv4 не настроен на локальном компьютере. |
|
Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки. |
Комментарии
В Windows Vista и более поздних версиях функция SetIpNetEntry может вызываться только пользователем, вошедшего в систему как участник группы Администраторы. Если метод SetIpNetEntry вызывается пользователем, не включаемым в группу Администраторы, вызов функции завершится ошибкой и ERROR_ACCESS_DENIED возвращается.
Функция SetIpNetEntry также может завершиться сбоем из-за контроля учетных записей (UAC) в Windows Vista и более поздних версиях. Если приложение, содержащее эту функцию, выполняется пользователем, вошедшего в систему как участник группы администраторов, отличный от встроенного администратора, этот вызов завершится ошибкой, если приложение не было отмечено в файле манифеста параметром requestedExecutionLevel , для которого задано значение requireAdministrator. Если в приложении отсутствует этот файл манифеста, пользователь, вошедший в группу администраторов, отличный от встроенного администратора, должен выполнять приложение в расширенной оболочке в качестве встроенного администратора (администратора запуска от имени) для успешного выполнения этой функции.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | iphlpapi.h |
Библиотека | Iphlpapi.lib |
DLL | Iphlpapi.dll |
См. также раздел
Справочник по вспомогательным функциям IP