estrutura RAS_PORT_1

  • Artigo

[Esta versão da estrutura de RAS_PORT_1 não tem suporte a partir do Windows Vista. Use o RAS_PORT_1 mais recente definido em mprapi.h em vez disso.]

A estrutura RAS_PORT_1 contém informações sobre uma porta RAS.

Sintaxe

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

Membros

rasport0

Especifica uma estrutura RAS_PORT_0 que contém informações sobre a porta, como o nome da porta, o nome do usuário remoto conectado à porta e assim por diante.

LineCondition

Especifica o estado da porta. Esse membro pode ser um dos valores a seguir.

Valor Significado
RAS_PORT_NON_OPERATIONAL
 A porta não está operacional. Verifique se há erros relatados pelo servidor no log de eventos.
RAS_PORT_DISCONNECTED
 A porta está desconectada no momento.
RAS_PORT_CALLING_BACK
 O servidor RAS está chamando de volta o cliente RAS.
RAS_PORT_LISTENING
 A porta está aguardando um cliente chamar.
RAS_PORT_AUTHENTICATING
 O servidor está no processo de autenticação do cliente remoto.
RAS_PORT_AUTHENTICATED
 O cliente remoto agora está autenticado.
RAS_PORT_INITIALIZING
 O dispositivo anexado à porta está sendo inicializado. O estado da porta será alterado para RAS_PORT_LISTENING quando a inicialização for concluída.

HardwareCondition

Especifica um dos valores a seguir para indicar o estado do dispositivo anexado à porta.

Valor Significado
RAS_MODEM_OPERATIONAL
 O modem anexado a essa porta está operacional e está pronto para receber chamadas de cliente.
RAS_MODEM_HARDWARE_FAILURE
 O modem anexado a essa porta tem um problema de hardware.

LineSpeed

Especifica a velocidade, em bits por segundo, com a qual o computador pode se comunicar com a porta.

NumStatistics

Este membro não é usado. As funções de administração ras, como a função RasAdminPortGetInfo , usam a estrutura RAS_PORT_STATISTICS para retornar estatísticas de porta.

NumMediaParms

Especifica o número de parâmetros específicos de mídia para essa porta. Para mídia serial, esse normalmente é o número de valores que aparecem no arquivo SERIAL.INI.

SizeMediaParms

Especifica o tamanho, em bytes, do buffer necessário para todos os parâmetros específicos da mídia. A função RasAdminPortGetInfo retorna um buffer que contém uma matriz de estruturas RAS_PARAMETERS com os parâmetros de mídia e os valores da porta.

ProjResult

Uma estrutura RAS_PPP_PROJECTION_RESULT que especifica as informações de projeção do PPP para essa porta. Essa estrutura fornece informações para cada protocolo negociado quando um cliente RAS se conecta a um servidor.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Fim do suporte ao cliente
 Windows XP
Fim do suporte ao servidor
 Windows Server 2003
Cabeçalho
Rassapi.h

Confira também

Visão geral do RAS (Serviço de Acesso Remoto)

Estruturas de administração do servidor RAS

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo