Función MprConfigInterfaceTransportSetInfo (mprapi.h)

Artículo
03/15/2023

La función MprConfigInterfaceTransportSetInfo actualiza la información de configuración del cliente en la interfaz y el protocolo de transporte especificados.

Sintaxis

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

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 en la que se va a actualizar la información. Obtenga este identificador llamando a MprConfigInterfaceCreate o MprConfigInterfaceEnum.

[in] hRouterIfTransport

Controle la configuración de transporte en la que se actualizará la información del cliente. Obtenga este identificador llamando a MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportGetHandle o MprConfigInterfaceTransportEnum. Los tipos de protocolo de transporte admitidos se enumeran en Identificadores de transporte.

[in, optional] pInterfaceInfo

Puntero a un encabezado de información que contiene información de configuración para el cliente en la interfaz y el transporte especificados. El administrador de enrutadores para el transporte especificado interpreta esta información. Use las funciones de encabezado de información para manipular encabezados de información.

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

[in, optional] dwInterfaceInfoSize

Especifica el tamaño, en bytes, de los datos a los que apunta pInterfaceInfo.

Este parámetro es opcional; la aplicación que llama puede especificar cero para este parámetro. Sin embargo, si pInterfaceInfo no es NULL, este parámetro no puede ser cero. Para obtener más información, vea la sección Comentarios más adelante en este tema.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. Para obtener más información, vea la sección Comentarios más adelante en este tema.

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. hRouterIfTransport es NULL.
ERROR_NO_SUCH_INTERFACE	La interfaz especificada por hRouterInterface ya no está presente en la configuración del enrutador o el transporte especificado por hRouterInterface ya no está presente en la interfaz.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

Si el parámetro pInterfaceInfo es NULL, MprConfigInterfaceTransportSetInfo no hace nada y devuelve inmediatamente con un valor de NO_ERROR.

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