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

Статья
08/24/2023

Функция UnenableRouter уменьшает количество ссылок, отслеживающих количество запросов для включения переадресации IPv4. Когда число ссылок достигает нуля, UnenableRouter отключает перенаправление IPv4 на локальном компьютере.

Синтаксис

IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
                  OVERLAPPED *pOverlapped,
  [out, optional] LPDWORD    lpdwEnableCount
);

Параметры

pOverlapped

Указатель на структуру OVERLAPPED . Эта структура должна совпадать с той, которая используется в вызове функции EnableRouter .

[out, optional] lpdwEnableCount

Необязательный указатель на переменную DWORD . Эта переменная получает количество оставшихся ссылок.

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

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

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

Функция UnenableRouter зависит от переадресации IPv4. Каждый вызов, выполняемый процессом unenableRouter , должен соответствовать предыдущему вызову EnableRouter тем же процессом. Система возвращает ошибку при посторонних вызовах UnenableRouter. В результате данный процесс не может уменьшать количество ссылок, отслеживающих количество запросов для включения переадресации IPv4 для другого процесса. Кроме того, если переадресация IPv4 была включена заданным процессом, она не может быть отключена другим процессом.

Невозможно точно определить количество ссылок, отслеживающих количество запросов для включения переадресации IPv4, так как могут существовать другие невыполненные запросы EnableRouter . Таким образом, значение, возвращаемое для параметра lpdwEnableCount , всегда является большим числом, равным ULONG_MAX/2.

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

После вызова UnenableRouter используйте вызов CloseHandle , чтобы закрыть дескриптор объекта события в структуре OVERLAPPED .

Требования

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