Función MprConfigInterfaceSetInfo (mprapi.h)

Artículo
03/15/2023

La función MprConfigInterfaceSetInfo establece la configuración de la interfaz especificada.

Sintaxis

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

Parámetros

[in] hMprConfig

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

[in] hRouterInterface

Identificador de la configuración de la interfaz que se está actualizando. Obtenga este identificador llamando a MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwLevel

Valor DWORD que describe el formato en el que la información está estructurada en el parámetro lpBuffer . 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
MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o estructura de MPR_INTERFACE_3 . El parámetro dwLevel indica el tipo de estructura. La información de esta estructura se usa para actualizar 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. hRouterInterface es NULL. dwLevel no es 0, 1, 2 o 3. lpBuffer es NULL. También devuelve este código de error si la interfaz es de tipo ROUTER_IF_TYPE_DEDICATED o ROUTER_IF_TYPE_INTERNAL y la interfaz está habilitada.
ERROR_NO_SUCH_INTERFACE	La interfaz que corresponde a hRouterInterface no está presente 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.

Comentarios

La función MprAdminInterfaceSetInfo admite la estructura MPR_INTERFACE_2 . Sin embargo, MprConfigInterfaceSetInfo no. Para realizar cambios persistentes en una interfaz de marcado a petición, llame a MprAdminInterfaceSetInfo con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

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