Función MprAdminConnectionGetInfo (mprapi.h)
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 |
---|---|
|
El identificador del servidor RAS o el identificador de la conexión RAS no es válido. |
|
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. |
|
El identificador hConnection no es válido. |
|
El identificador hRasServer no es válido. |
|
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 |