Función MprAdminTransportCreate (mprapi.h)

La función MprAdminTransportCreate carga un nuevo transporte e inicia el administrador del enrutador para el transporte.

Sintaxis

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Parámetros

[in] hMprServer

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

[in] dwTransportId

Valor DWORD que describe el tipo de configuración de transporte que se va a establecer. 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, optional] lpwsTransportName

Puntero a una cadena Unicode terminada en null que especifica el nombre del transporte.

[in] pGlobalInfo

Puntero a un búfer que especifica información global para el transporte. 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 búfer que especifica la información predeterminada de la interfaz de cliente para el transporte.

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no establece la información predeterminada de la interfaz de cliente.

[in, optional] dwClientInterfaceInfoSize

Especifica el tamaño, en bytes, del búfer al que apunta el parámetro pClientInterfaceInfo .

[in] lpwsDLLPath

Puntero a una cadena Unicode terminada en null que especifica la ruta de acceso al archivo DLL para el transporte.

Valor devuelto

Si la función se realiza 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_PARAMETER	El parámetro pGlobalInfo y el parámetro pClientInterfaceInfo son NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_PROTOCOL_ALREADY_INSTALLED	El transporte especificado ya se está ejecutando en el enrutador especificado.
ERROR_UNKNOWN_PROTOCOL_ID	El valor dwTransportId no coincide con ningún protocolo de transporte admitido.

Requisitos

Requisito	Value
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

MprAdminTransportGetInfo

MprAdminTransportSetInfo