Função MprAdminServerSetInfo (mprapi.h)
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 |
---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
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 . |
|
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. |
|
O serviço RRAS não está em execução neste servidor. |
|
O valor de dwLevel não é válido. |
|
O identificador hMprServer é inválido. |
|
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 |