Función MprConfigInterfaceTransportAdd (mprapi.h)

Artículo
08/24/2023

La función MprConfigInterfaceTransportAdd agrega un protocolo de transporte a una configuración de interfaz en el enrutador.

Sintaxis

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

Parámetros

[in] hMprConfig

Controle la configuración del enrutador. Obtenga este identificador llamando a MprConfigServerConnect.

[in] hRouterInterface

Controle la configuración de la interfaz a la que se agrega el transporte especificado. Obtenga este identificador llamando a MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwTransportId

Valor DWORD que describe el transporte que se va a agregar a la configuración. Este parámetro también identifica el administrador de enrutadores para el transporte. Los valores aceptables para dwTransportId se enumeran en la tabla siguiente.

Valor	Transporte (familia de protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo de Internet versión 4
PID_IPX	Intercambio de paquetes de Internet
PID_NBF	Protocolo de marcos NetBIOS
PID_IPV6	Windows Server 2008 o posterior: Protocolo de Internet versión 6

[in, optional] lpwsTransportName

Puntero a una cadena Unicode terminada en null que especifica el nombre del transporte que se va a agregar. Si no se especifica este parámetro y el transporte es IP o IPX, MprConfigInterfaceTransportAdd usa IP o IPX. Si no se especifica este parámetro y el transporte es distinto de IP o IPX, MprConfigInterfaceTransportAdd convierte el parámetro dwTransportId en una cadena y lo usa como nombre de transporte.

[in] pInterfaceInfo

Puntero a un encabezado de información que contiene información para la interfaz y el transporte especificados. El administrador de enrutadores para el transporte especificado interpreta esta información. Use las funciones de encabezado de información para manipular encabezados de información.

[in] dwInterfaceInfoSize

Especifica el tamaño, en bytes, de los datos a los que apunta pInterfaceInfo.

[out] phRouterIfTransport

Puntero a
Variable HANDLE que recibe el tipo de identificador de configuración de transporte para esta interfaz indicado en el parámetro dwTransportId .

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	Significado
ERROR_INVALID_PARAMETER	Una de las siguientes condiciones se cumple: hMprConfig es NULL. hRouterInterface es NULL. phRouterIfTransport es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

Además de especificar un transporte, el parámetro dwTransportId también especifica un administrador de enrutadores, ya que un enrutador mantiene un administrador de enrutador único para cada transporte.

Si el transporte especificado ya existe, MprConfigInterfaceTransportAdd realiza el equivalente de una llamada MprConfigInterfaceTransportSetInfo mediante los valores de parámetro especificados.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll