Поделиться через

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

  • Статья

Функция DeletePersistentUdpPortReservation удаляет постоянное резервирование TCP-портов для последовательного блока TCP-портов на локальном компьютере.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG DeletePersistentUdpPortReservation(
  [in] USHORT StartPort,
  [in] USHORT NumberOfPorts
);

Параметры

[in] StartPort

Начальный номер порта UDP в порядке сетевых байтов.

[in] NumberOfPorts

Число удаляемых номеров портов UDP.

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
 Отказано в доступе". Эта ошибка возвращается при нескольких условиях, которые включают следующее: у пользователя отсутствуют необходимые права администратора на локальном компьютере или приложение не выполняется в расширенной оболочке в качестве встроенного администратора (администратора запуска от имени).
ERROR_INVALID_PARAMETER
 В функцию передан недопустимый параметр. Эта ошибка возвращается, если в параметрах StartPort или NumberOfPorts передается ноль.
ERROR_NOT_FOUND
 Элемент не обнаружен. Эта ошибка возвращается, если не удалось найти постоянный блок портов, указанный параметрами StartPort и NumberOfPorts .
Другое
 Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Комментарии

Функция DeletePersistentUdpPortReservation определена в Windows Vista и более поздних версиях.

Функция DeletePersistentUdpPortReservation используется для удаления постоянного резервирования для блока портов UDP.

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

Требования

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

См. также раздел

CreatePersistentTcpPortReservation

CreatePersistentUdpPortReservation

DeletePersistentTcpPortReservation

LookupPersistentTcpPortReservation

LookupPersistentUdpPortReservation