Compartir a través de

Función MprConfigInterfaceCreate (mprapi.h)

  • Artículo

La función MprConfigInterfaceCreate crea una interfaz de enrutador en la configuración del enrutador especificada.

Sintaxis

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Parámetros

[in] hMprConfig

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

[in] dwLevel

Valor DWORD que describe el formato en el que la información se estructura en el parámetro lpbBuffer . Los valores aceptables para dwLevel incluyen 0, 1, 2 y 3, como se muestra en la tabla siguiente.

Valor Formato de estructura
0 MPR_INTERFACE_0
1 MPR_INTERFACE_1
2 MPR_INTERFACE_2
3 Windows Server 2008 o posterior: MPR_INTERFACE_3

[in] lpbBuffer

Puntero a un MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o estructura de MPR_INTERFACE_3 . El parámetro dwLevel indica el tipo de estructura.

[out] phRouterInterface

Puntero a una variable de identificador. Esta variable recibe un identificador para la configuración de la interfaz.

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
  • dwLevel no es 0, 1, 2 o 3.
  • lpbBuffer es NULL
  • phRouterInterface es NULL
ERROR_NOT_ENOUGH_MEMORY
 Recursos insuficientes para completar la operación.
Otros
 Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

La función MprAdminInterfaceCreate admite la estructura MPR_INTERFACE_2 . Sin embargo, MprConfigInterfaceCreate no. Para crear una interfaz de marcado a petición que sea persistente después de un reinicio, llame a MprAdminInterfaceCreate con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1.

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

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

Funciones de configuración del enrutador

Referencia de administración de enrutadores