Compartir a través de


Función MprAdminInterfaceTransportAdd (mprapi.h)

La función MprAdminInterfaceTransportAdd agrega un transporte (por ejemplo, IP o IPX) a una interfaz especificada.

Sintaxis

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Parámetros

[in] hMprServer

Controle al enrutador en el que se agrega información. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz en la que se agrega el transporte. Este identificador se obtiene mediante una llamada anterior a MprAdminInterfaceCreate.

[in] dwTransportId

Valor DWORD que describe el tipo de transporte que se va a agregar a la interfaz. Los valores aceptables para dwTransportId se muestran 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] pInterfaceInfo

Puntero a un encabezado de información que especifica información de interfaz para este transporte. Use las funciones de encabezado de información para manipular encabezados de información.

[in] dwInterfaceInfoSize

Especifica el tamaño, en bytes, de la información a la que apunta pInterfaceInfo.

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_ACCESS_DENIED
La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_INVALID_HANDLE
El valor hInterface no es válido.
ERROR_INVALID_PARAMETER
El parámetro pInterfaceInfo es NULL.
ERROR_UNKNOWN_PROTOCOL_ID
El valor dwTransportId no coincide con ningún transporte admitido.

Comentarios

El parámetro dwTransportId también especifica el administrador del enrutador porque un enrutador usa un administrador de enrutadores diferente para cada transporte.

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

Consulte también

MprAdminInterfaceCreate

MprAdminInterfaceTransportRemove

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores