Partilhar via

Sobre o servidor RAS e a administração de porta

  • Artigo

As funções de administração do servidor RAS obtêm informações sobre um servidor RAS especificado e suas portas. Essas funções também são usadas para encerrar uma conexão em uma porta de servidor RAS especificada.

A função MprAdminServerGetInfo retorna uma estrutura MPR_SERVER_0 que contém informações sobre a configuração de um servidor RAS. As informações retornadas incluem o número de portas atualmente disponíveis para conexões, o número de portas atualmente em uso e o número de versão do servidor.

A função MprAdminPortEnum recupera uma matriz de estruturas RAS_PORT_0 . Cada estrutura contém informações para uma das portas configuradas em um servidor RAS. As informações de cada porta incluem:

  • O nome da porta
  • Informações sobre o dispositivo anexado à porta
  • Se o servidor RAS associado à porta é um servidor Windows NT/Windows 2000
  • Se a porta está atualmente em uso e, se for, informações sobre a conexão

Para obter as portas em uso por uma conexão específica, passe mprAdminPortEnum um identificador para essa conexão no parâmetro hConnection . Para obter um identificador para uma conexão, use a função MprAdminConnectionEnum . Como alternativa, se você tiver implementado uma DLL de Administração ras, as funções MprAdminAcceptNewConnection e MprAdminAcceptNewConnection2 receberão um identificador para cada nova conexão no momento em que a conexão for estabelecida.

Você pode chamar a função MprAdminPortGetInfo para obter informações adicionais sobre uma porta especificada em um servidor RAS. Essa função retorna uma estrutura RAS_PORT_1 que contém uma estrutura RAS_PORT_0 e informações adicionais sobre o estado atual da porta. A função RasAdminPortGetInfo também retorna uma matriz de estruturas RAS_PARAMETERS que descrevem os valores de quaisquer chaves específicas da mídia associadas à porta. Uma estrutura RAS_PARAMETERS usa um valor da enumeração RAS_PARAMS_FORMAT para indicar o formato do valor para cada chave específica da mídia.

A função MprAdminPortGetInfo também retorna uma estrutura RAS_PORT_STATISTICS que contém vários contadores de estatística para a conexão atual, se houver, na porta. Para uma porta que faz parte de uma conexão multilink, MprAdminPortGetInfo retorna estatísticas para a porta individual e estatísticas cumulativas para todas as portas envolvidas na conexão. Você pode usar a função MprAdminPortClearStats para redefinir os contadores de estatística para a porta. A função MprAdminPortDisconnect desconecta uma porta que está em uso.

Use a função MprAdminBufferFree para liberar a memória alocada pelas funções MprAdminPortEnum e MprAdminPortGetInfo . Use a função MprAdminGetErrorString para obter uma cadeia de caracteres que descreve um código de erro RAS retornado por uma das funções rasAdmin (administração do servidor RAS).