Compartir a través de

Función MprAdminInterfaceGetInfo (mprapi.h)

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

Consulte también

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MPR_INTERFACE_3

MprAdminBufferFree

MprAdminInterfaceCreate

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores

  • Last updated on