Función MprConfigInterfaceGetInfo (mprapi.h)

Artículo
08/24/2023

La función MprConfigInterfaceGetInfo recupera la configuración de la interfaz especificada del enrutador.

Sintaxis

DWORD MprConfigInterfaceGetInfo(
  [in]      HANDLE  hMprConfig,
  [in]      HANDLE  hRouterInterface,
  [in]      DWORD   dwLevel,
  [in, out] LPBYTE  *lplpBuffer,
  [out]     LPDWORD lpdwBufferSize
);

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

[in] dwLevel

Valor DWORD que describe el formato en el que se devuelve la información en el parámetro lplpBuffer . 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, out] lplpBuffer

En la entrada, un puntero distinto de NULL .

Al finalizar correctamente, un puntero a una matriz de MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o estructura de MPR_INTERFACE_3 . El parámetro dwLevel indica el tipo de estructura. Libere este búfer llamando a MprConfigBufferFree.

[out] lpdwBufferSize

Puntero a una variable DWORD . Esta variable recibe el tamaño, en bytes, de los datos devueltos a través de lplpBuffer.

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. lplpBuffer es NULL lpdwBufferSize es NULL
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_NO_SUCH_INTERFACE	La interfaz que corresponde a hRouterInterface no está presente en la configuración del enrutador.

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