Função MprAdminServerSetInfo (mprapi.h)

Artigo
08/24/2023

A função MprAdminServerSetInfo é usada para definir o número de portas para dispositivos L2TP, PPTP e SSTP quando o serviço RRAS está em execução.

Sintaxe

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

Parâmetros

[in] hMprServer

Manipule para o roteador a ser consultado. Obtenha esse identificador chamando MprAdminServerConnect.

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

Retornar valor

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_DDM_NOT_RUNNING	O serviço RRAS não está em execução neste servidor.
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

Essa função é usada para definir a contagem de portas para portas L2TP, PPTP e SSTP e habilitar ou desabilitar o RRAS quando o serviço estiver em execução. Esses valores são persistentes, o que significa que você não precisa seguir essa chamada com uma chamada para MprConfigServerSetInfo. Observe que essa função é assíncrona, portanto, talvez você não veja o efeito das alterações imediatamente.

Exemplos

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

Requisitos

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