Función MprConfigTransportGetHandle (mprapi.h)

La función MprConfigTransportGetHandle recupera un identificador de la configuración del protocolo de transporte especificado en la configuración del enrutador especificado.

Sintaxis

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

Parámetros

[in] hMprConfig

Controle la configuración del enrutador. El identificador se obtiene de una llamada anterior a MprConfigServerConnect.

[in] dwTransportId

Valor DWORD que describe el tipo de identificador de configuración de transporte en el parámetro phRouterTransport . 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

[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
ERROR_INVALID_PARAMETER	El parámetro hMprConfig o el parámetro phRouterTransport es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_UNKNOWN_PROTOCOL_ID	El protocolo de transporte especificado por dwTransportId no se encontró en la configuración del enrutador.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

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

FormatMessage

MprConfigServerConnect

Funciones de configuración del enrutador

Referencia de administración de enrutadores