Función MprConfigTransportCreate (mprapi.h)
La función MprConfigTransportCreate agrega el transporte especificado a la lista de protocolos de transporte presentes en la configuración del enrutador especificada.
Sintaxis
DWORD MprConfigTransportCreate(
[in] HANDLE hMprConfig,
[in] DWORD dwTransportId,
[in, optional] LPWSTR lpwsTransportName,
[in] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in, optional] DWORD dwClientInterfaceInfoSize,
[in, optional] LPWSTR lpwsDLLPath,
[out] HANDLE *phRouterTransport
);
Parámetros
[in] hMprConfig
Controle la configuración del enrutador a la que se va a agregar el transporte. Obtenga este identificador llamando a MprConfigServerConnect.
[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, el parámetro dwTransportId se convierte en una cadena y se usa como nombre de transporte.
[in] pGlobalInfo
Puntero a un encabezado de información que especifica información global para el transporte. El administrador de enrutadores para el transporte interpreta esta información. Use las funciones de encabezado de información para manipular encabezados de información.
[in] dwGlobalInfoSize
Especifica el tamaño, en bytes, de los datos a los que apunta el parámetro pGlobalInfo .
[in, optional] pClientInterfaceInfo
Puntero a un encabezado de información que especifica información de interfaz predeterminada para los enrutadores cliente. Esta información se usa para configurar interfaces dinámicas para enrutadores cliente para este transporte. Use las funciones de encabezado de información para manipular encabezados de información.
Este parámetro es opcional; la aplicación que llama puede especificar NULL para este parámetro.
[in, optional] dwClientInterfaceInfoSize
Especifica el tamaño, en bytes, de los datos a los que apunta el parámetro pClientInterfaceInfo . Si la aplicación que llama especifica NULL para pClientInterfaceInfo, la aplicación que llama debe especificar cero para este parámetro.
[in, optional] lpwsDLLPath
Puntero a una cadena Unicode terminada en null que especifica el nombre del archivo DLL del administrador de enrutadores para el transporte especificado. Si se especifica este nombre, la función establece la ruta de acceso dll para este transporte a este nombre.
Este parámetro es opcional; la aplicación que llama puede especificar NULL para este parámetro.
[out] phRouterTransport
Puntero a
Variable HANDLE que recibe el tipo de identificador de configuración de transporte 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 |
|---|---|
|
El parámetro hMprConfig es NULL o el parámetro phRouterTransport es NULL o ambos son NULL. |
|
Recursos insuficientes para completar la operación. |
|
Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto. |
Comentarios
Si el transporte especificado ya existe, MprConfigTransportCreate realiza el equivalente de una llamada MprConfigTransportSetInfo mediante los valores de parámetro proporcionados.
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 |