Compartir a través de


Función MprAdminInterfaceTransportGetInfo (mprapi.h)

La función MprAdminInterfaceTransportGetInfo recupera información sobre un transporte que se ejecuta en una interfaz especificada.

Sintaxis

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Parámetros

[in] hMprServer

Controle al enrutador desde el que se recupera la información. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz. Este identificador se obtiene de una llamada anterior a MprAdminInterfaceCreate.

[in] dwTransportId

Valor DWORD que describe el transporte para el que se solicita información. 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

[out] ppInterfaceInfo

Puntero a una variable de puntero. La variable de puntero apunta a un encabezado de información que recibe información para la interfaz y el transporte especificados. Use las funciones de encabezado de información para manipular encabezados de información. Libere esta memoria llamando a MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Puntero a una variable DWORD . Esta variable recibe el tamaño en bytes de la información de interfaz devuelta a través del parámetro ppInterfaceInfo .

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve el tamaño de la información de la interfaz.

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_HANDLE
El valor hInterface no es válido o si la interfaz especificada está deshabilitada administrativamente.
ERROR_NO_SUCH_INTERFACE
El transporte especificado no se ejecuta en la interfaz especificada.
ERROR_NOT_ENOUGH_MEMORY
Recursos insuficientes para completar la operación.
ERROR_UNKNOWN_PROTOCOL_ID
El valor dwTransportId no coincide con ningún transporte admitido.

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

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores