Función MprConfigServerGetInfo (mprapi.h)

Artículo
03/15/2023

La función MprConfigServerGetInfo recupera información de configuración de nivel de servidor para el enrutador especificado.

Sintaxis

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

Parámetros

[in] hMprConfig

Controle la configuración del enrutador. Obtenga este identificador llamando a MprConfigServerConnect.

[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 MprConfigBufferFree.

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_INVALID_PARAMETER	Se cumple al menos una de las siguientes condiciones: El parámetro hMprConfig es NULL. El parámetro dwLevel no es cero. El parámetro lplpBuffer es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

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