Função MprConfigServerSetInfo (mprapi.h)

Artigo
08/24/2023

A função MprConfigServerSetInfo é usada para definir a contagem de portas para portas L2TP, PPTP e SSTP e habilitar ou desabilitar o RRAS neles no registro quando o serviço RRAS não estiver em execução para que ele seja pego na próxima vez que o sistema for reiniciado.

Sintaxe

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

Parâmetros

[in] hMprServer

Manipule para a configuração do roteador. Obtenha esse identificador chamando MprConfigServerConnect.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são estruturadas no parâmetro lpbBuffer . Os valores aceitáveis para dwLevel incluem 1 e 2 conforme listado na tabela a seguir.

Valor	Formato de estrutura
1	Windows Server 2003 ou posterior: MPR_SERVER_1
2	Windows Server 2008 ou posterior: MPR_SERVER_2

[in] lpbBuffer

Um ponteiro para um MPR_SERVER_1
ou MPR_SERVER_2 estrutura. O parâmetro dwLevel indica o tipo de estrutura.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor	Significado
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_SUCCESS_REBOOT_REQUIRED	Uma reinicialização do sistema é necessária para que essa alteração afete. Altere a contagem de portas usando a chamada e a reinicialização mprConfigServerSetInfo .
ERROR_INVALID_PARAMETER	Se você tentar definir o número de portas para mais do que os limites com suporte do sistema, conforme definido nos tópicos MPR_SERVER_1 e MPR_SERVER_2 . Retorna esse erro se você tentar definir o número de portas PPTP como 0. Retorna esse erro se os sinalizadores não forem válidos ou se lpbBuffer ou hMprServer for NULL.
ERROR_NOT_SUPPORTED	O valor de dwLevel não é válido.
ERROR_INVALID_HANDLE	O identificador hMprServer é inválido.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

Essas alterações em uma configuração de servidor são persistentes, mas não têm efeito em um servidor RRAS até que ele seja reiniciado.

Exemplos

O tópico Configurando portas L2TP e PPTP de um serviço RRAS local mostra essa função em uso.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll