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

Статья
08/25/2023

Функция SetInterfaceInfo задает конфигурацию определенного интерфейса, управляемого протоколом маршрутизации.

Синтаксис

PSET_INTERFACE_INFO PsetInterfaceInfo;

DWORD PsetInterfaceInfo(
  [in] ULONG InterfaceIndex,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Параметры

[in] InterfaceIndex

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

[in] InterfaceInfo

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

[in] StructureVersion

Указывает версию информационных структур, на которые указывает параметр InterfaceInfo . В некоторых случаях это значение равно версии протокола маршрутизации.

[in] StructureSize

Задает размер каждой информационной структуры, на которую указывает параметр InterfaceInfo . Так как некоторые информационные структуры содержат элементы переменной длины, протокол маршрутизации не обязательно может определить размер сведений из версии.

[in] StructureCount

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

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

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

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

Значение	Описание
ERROR_CAN_NOT_COMPLETE	Попытка задать конфигурацию интерфейса завершилась сбоем.
ERROR_INVALID_PARAMETER	Недопустимый параметр InterfaceIndex (например, не существует интерфейса с этим индексом), параметр InterfaceInfo имеет значение NULL или один из параметров в сведениях о конфигурации является недопустимым.

Требования

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

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

GetInterfaceInfo

Функции интерфейса протокола маршрутизации

Справочник по интерфейсу протокола маршрутизации

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