Función MprAdminServerGetInfo (mprapi.h)

Artículo
08/24/2023

La función MprAdminServerGetInfo recupera información sobre el servidor RRAS especificado.

Sintaxis

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parámetros

[in] hMprServer

Identificador del enrutador que se va a consultar. Obtenga este identificador llamando a MprAdminServerConnect.

[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 y 2, como se muestra en la tabla siguiente.

Valor	Formato de estructura
0	Windows 2000 Server o posterior: MPR_SERVER_0
1	Windows Server 2003 o posterior: MPR_SERVER_1
2	Windows Server 2008 o posterior: MPR_SERVER_2

[out] lplpbBuffer

Al finalizar correctamente, un puntero a un MPR_SERVER_0, MPR_SERVER_1,
o MPR_SERVER_2 estructura. El parámetro dwLevel indica el tipo de estructura. Libere la memoria de este búfer mediante 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_PARAMETER	El parámetro lplpbBuffer es NULL.
RPC_S_INVALID_BINDING	El parámetro hMprServer es NULL.

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