Función MprConfigServerSetInfo (mprapi.h)

Artículo
03/15/2023

La función MprConfigServerSetInfo se usa para establecer el recuento de puertos para los puertos L2TP, PPTP y SSTP y habilitar o deshabilitar RRAS en el registro cuando el servicio RRAS no se está ejecutando para que se seleccione la próxima vez que se reinicie el sistema.

Sintaxis

DWORD MprConfigServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parámetros

[in] hMprServer

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

[in] dwLevel

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

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

[in] lpbBuffer

Puntero a un MPR_SERVER_1
o MPR_SERVER_2 estructura. El parámetro dwLevel indica el tipo de estructura.

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_SUCCESS_REBOOT_REQUIRED	Se requiere un reinicio del sistema para que este cambio surta efecto. Cambie el número de puertos mediante la llamada y el reinicio de MprConfigServerSetInfo .
ERROR_INVALID_PARAMETER	Si intenta establecer el número de puertos en más de los límites admitidos por el sistema, tal como se define en los temas MPR_SERVER_1 y MPR_SERVER_2 . Devuelve este error si intenta establecer el número de puertos PPTP en 0. Devuelve este error si las marcas no son válidas o si lpbBuffer o hMprServer son NULL.
ERROR_NOT_SUPPORTED	El valor de dwLevel no es válido.
ERROR_INVALID_HANDLE	El identificador hMprServer no es válido.
Otros	Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

Estos cambios en una configuración de servidor son persistentes, pero no tienen ningún efecto en un servidor RRAS hasta que se reinicie.

Ejemplos

El tema Establecimiento de puertos L2TP y PPTP de un servicio RRAS local muestra esta función en uso.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll