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