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 |
---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
El valor hInterface no es válido. |
|
El parámetro pInterfaceInfo es NULL. |
|
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
MprAdminInterfaceTransportRemove