Función MprAdminInterfaceGetInfo (mprapi.h)

Artículo
08/24/2023

La función MprAdminInterfaceGetInfo recupera información de una interfaz especificada en un servidor especificado.

Sintaxis

DWORD MprAdminInterfaceGetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            *lplpbBuffer
);

Parámetros

[in] hMprServer

Identificador del enrutador que se va a consultar. Este identificador se obtiene de una llamada anterior a MprAdminServerConnect.

[in] hInterface

Controle la interfaz obtenida por una llamada anterior a MprAdminInterfaceCreate.

[in] dwLevel

Valor DWORD que describe el formato en el que la información está estructurada en el parámetro lplpbBuffer . 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

Los valores de 1, 2 y 3 solo son válidos para interfaces de tipo ROUTER_CONNECTION_STATE.

[in] lplpbBuffer

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. Libere esta memoria llamando a MprAdminBufferFree.

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_ACCESS_DENIED	La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_INVALID_LEVEL	DwLevel es 2, pero ese nivel no se admite para la interfaz. Por ejemplo, el tipo de interfaz, tal como se define en la estructura MPR_INTERFACE_X, no es IF_TYPE_FULL_ROUTER.
ERROR_INVALID_HANDLE	El valor hInterface no es válido.
ERROR_INVALID_PARAMETER	El parámetro lplpbBuffer es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_NOT_SUPPORTED	El valor dwLevel no es válido.

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