функция обратного вызова PINTERFACE_STATUS (routprot.h)

Статья
08/25/2023

Диспетчер маршрутизатора вызывает функцию InterfaceStatus для изменения состояния интерфейса.

Тип PINTERFACE_STATUS определяет указатель на эту функцию обратного вызова. InterfaceStatus — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PINTERFACE_STATUS PinterfaceStatus;

DWORD PinterfaceStatus(
  [in] ULONG InterfaceIndex,
  [in] BOOL InterfaceActive,
  [in] DWORD StatusType,
  [in] PVOID StatusInfo
)
{...}

Параметры

[in] InterfaceIndex

Указывает индекс интерфейса, который требуется изменить.

[in] InterfaceActive

Указывает, активен ли интерфейс.

[in] StatusType

Указывает состояние нового интерфейса. Этот параметр является одним из следующих значений.

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

Указатель на структуру, указывающую сведения, соответствующие типу состояния интерфейса. Например, если параметр StatusType указывает изменение адреса, параметр StatusInfo указывает на структуру, содержащую новые сведения об адресе, например IP_ADAPTER_BINDING_INFO. Этот параметр может иметь значение NULL.

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

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

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

Значение	Описание
ERROR_CAN_NOT_COMPLETE	Неуказанным сбоем.
ERROR_INVALID_PARAMETER	Недопустимый параметр InterfaceIndex (например, интерфейс с этим индексом не существует).

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	routprot.h

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

AddInterface

DeleteInterface

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