Función MprAdminServerSetInfo (mprapi.h)

Artículo
02/29/2024

La función MprAdminServerSetInfo se usa para establecer el número de puertos para dispositivos L2TP, PPTP y SSTP cuando se ejecuta el servicio RRAS.

Sintaxis

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

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 la información se estructura 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 recuento 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 de 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_DDM_NOT_RUNNING	El servicio RRAS no se ejecuta en este servidor.
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

Esta función se usa para establecer el recuento de puertos para los puertos L2TP, PPTP y SSTP, y habilitar o deshabilitar RRAS cuando se ejecuta el servicio. Estos valores son persistentes, lo que significa que no es necesario seguir esta llamada con una llamada a MprConfigServerSetInfo. Tenga en cuenta que esta función es asincrónica, por lo que es posible que no vea el efecto de los cambios inmediatamente.

Ejemplos

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

Requisitos

Requisito	Value
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