Compartir a través de

PADD_INTERFACE función de devolución de llamada (routprot.h)

  • Artículo

La función AddInterface agrega una interfaz para que la administre el protocolo de enrutamiento. El protocolo debe considerar que la interfaz está en estado deshabilitado. El administrador de enrutadores habilita la interfaz llamando a InterfaceStatus con la marca RIS_INTERFACE_ENABLED.

Cuando un usuario llama a MprAdminInterfaceTransportAdd, el administrador de interfaces dinámicas para el transporte llama al administrador de enrutadores (para el transporte) que llama a esta función para cada uno de los protocolos de enrutamiento asociados a ese transporte.

Sintaxis

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parámetros

[in] InterfaceName

Puntero a una cadena Unicode. La cadena contiene un nombre que identifica de forma única la interfaz en el conjunto de interfaces configuradas en el enrutador.

[in] InterfaceIndex

Especifica la interfaz en el conjunto de interfaces configuradas en el enrutador.

[in] InterfaceType

Especifica el tipo de la interfaz.

Valor Significado
PERMANENTE
 Conectividad permanente (por ejemplo, LAN, Frame Relay).
DEMAND_DIAL
 Conectividad de marcado a petición (analógico, ISDN, PPTP, FR conmutada).
LOCAL_WORKSTATION_DIAL
 Solo conectividad de estación de trabajo local.
REMOTE_WORKSTATION_DIAL
 Solo conectividad de estación de trabajo remota.

[in] MediaType

Reservado para un uso futuro.

[in] AccessType

Reservado para un uso futuro.

[in] ConnectionType

Reservado para un uso futuro.

[in] InterfaceInfo

Puntero a un búfer que especifica la información de configuración definida por el protocolo asociada a la interfaz. Esta información es privada para el protocolo de enrutamiento.

[in] StructureVersion

Especifica la versión de las estructuras de información a las que apunta el parámetro InterfaceInfo . En algunos casos, esto es igual a la versión del protocolo de enrutamiento.

[in] StructureSize

Especifica el tamaño de cada una de las estructuras de información a las que apunta el parámetro InterfaceInfo . Dado que algunas estructuras de información contienen miembros de longitud variable, el protocolo de enrutamiento no es necesariamente capaz de determinar el tamaño de la información de la versión.

[in] StructureCount

Especifica un recuento del número de estructuras de información a las que apunta el parámetro InterfaceInfo . Este parámetro siempre es uno.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Descripción
ERROR_CAN_NOT_COMPLETE
 Error al intentar agregar la interfaz.
ERROR_INVALID_PARAMETER
 El parámetro InterfaceIndex no es válido (por ejemplo, una interfaz con ese índice ya existe) o uno de los parámetros a los que apunta InterfaceInfo no es válido.
 
 

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado routprot.h

Consulte también

DeleteInterface

Funciones de interfaz de protocolo de enrutamiento

Referencia de interfaz de protocolo de enrutamiento