Función MprConfigInterfaceTransportGetHandle (mprapi.h)

Artículo
02/29/2024

La función MprConfigInterfaceTransportGetHandle recupera un identificador para la configuración de transporte de una interfaz en la configuración del enrutador especificada.

Sintaxis

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Parámetros

[in] hMprConfig

Controle la configuración del enrutador. Obtenga este identificador llamando a MprConfigServerConnect.

[in] hRouterInterface

Controle la configuración de la interfaz. Obtenga este identificador llamando a MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwTransportId

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

Puntero a
Variable HANDLE que recibe el tipo de identificador de configuración de transporte para esta interfaz 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	Se cumple al menos una de las siguientes condiciones: hMprConfig es NULL. hRouterInterface es NULL. phRouterIfTransport es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_NO_SUCH_INTERFACE	La interfaz especificada por hRouterInterface no se encontró en la configuración del enrutador o el transporte especificado por dwTransportId no se ha habilitado en la interfaz especificada.
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