Función MprAdminConnectionGetInfo (mprapi.h)

Artículo
08/24/2023

La función MprAdminConnectionGetInfo recupera datos sobre una conexión específica.

Sintaxis

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

Parámetros

[in] hRasServer

Identificador del equipo desde el que se recupera la información de conexión. Para obtener este identificador, llame a MprAdminServerConnect.

[in] dwLevel

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

Windows NT 4.0: Este parámetro debe ser cero.

Valor	Formato de estructura
0	RAS_CONNECTION_0
1	Windows 2000 o posterior: RAS_CONNECTION_1
2	Windows 2000 o posterior: RAS_CONNECTION_2
3	Windows Server 2008 o posterior: RAS_CONNECTION_3

[in] hRasConnection

Identificador de la conexión para recuperar datos. Para obtener este identificador, llame a MprAdminConnectionEnum.

[out] lplpbBuffer

Al finalizar correctamente, un puntero a una matriz de estructuras que describen la conexión. Estas estructuras son de tipo RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 o RAS_CONNECTION_3, según el valor del parámetro dwLevel .

Para liberar esta memoria, llame 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 códigos de error enumerados en la tabla siguiente.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	El identificador del servidor RAS o el identificador de la conexión RAS no es válido.
ERROR_INVALID_LEVEL	El valor pasado para dwLevel no es cero, uno, dos o tres. Los niveles uno y dos solo se admiten en Windows 2000 o posterior. El nivel tres solo se admite en Windows Server 2008 o posterior.
ERROR_INTERFACE_NOT_CONNECTED	El identificador hConnection no es válido.
RPC_S_INVALID_BINDING	El identificador hRasServer no es válido.
Otros	Error de MprError.h, RasError.h o WinError.h.

Comentarios

Esta función está disponible en Windows NT 4.0 si está instalado el redistribuible RRAS. Sin embargo, la versión de Mprapi.dll incluida en el redistribuible RRAS exporta la función como RasAdminConnectionGetInfo en lugar de MprAdminConnectionGetInfo. Por lo tanto, al usar el redistribuible RRAS, use LoadLibrary y GetProcAddress para acceder a esta función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
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