Compartilhar via


estrutura RAS_PORT_0

[Não há suporte para esta versão da estrutura de RAS_PORT_0 a partir do Windows Vista. Use o RAS_PORT_0 mais recente definido em mprapi.h em vez disso.]

A estrutura RAS_PORT_0 contém informações que descrevem uma porta RAS.

Sintaxe

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

Membros

wszPortName

Uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da porta, como "COM1".

wszDeviceType

Uma cadeia de caracteres Unicode terminada em nulo que especifica o tipo do dispositivo no qual a conexão foi feita, como Modem ou ISDN. A lista de tipos de dispositivo que podem ser especificados neste membro inclui todos os tipos de dispositivo instalados no servidor, incluindo dispositivos de terceiros.

wszDeviceName

Uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do dispositivo no qual a conexão foi feita, como "Hayes 9600" ou "PCIMACISDN1".

wszMediaName

Especifica uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da mídia usada para a conexão, como rasser ou rastapi.

reserved

Reservado.

Sinalizadores

Especifica um conjunto de sinalizadores de bits que especificam a natureza da conexão feita nessa porta. Esse membro pode ser uma combinação dos sinalizadores a seguir.

Valor Significado
GATEWAY_ACTIVE
Se esse sinalizador estiver definido, o gateway NetBIOS estará ativo no servidor.
MESSENGER_PRESENT
Se esse sinalizador estiver definido, o serviço messenger estará em execução no cliente remoto.
PORT_MULTILINKED
Se esse sinalizador estiver definido, a porta será multilink com outras portas. Use essas informações para exibir a conexão status como uma porta multilink.
Para uma porta multilink, a estrutura RAS_PORT_STATISTICS contém dois conjuntos de estatísticas: um para a porta sozinho e outro para as portas combinadas na conexão multilink.
PPP_CLIENT
Se esse sinalizador estiver definido, o cliente remoto conectado usando PPP. Se esse sinalizador não estiver definido, o cliente remoto será conectado usando o protocolo AMB.
REMOTE_LISTEN
Se esse sinalizador estiver definido, o parâmetro RemoteListen do gateway NetBIOS será definido como 1 no servidor.
USER_AUTHENTICATED
Se esse sinalizador estiver definido, um cliente remoto será conectado ao servidor e o usuário será autenticado. Verifique esse sinalizador para garantir que um cliente esteja realmente conectado a uma porta.

Se os sinalizadores MESSENGER_PRESENT, GATEWAY_ACTIVE e REMOTE_LISTEN estiverem definidos, use o serviço messenger para enviar uma mensagem administrativa ao cliente remoto. Se MESSENGER_PRESENT e REMOTE_LISTEN estiverem definidos, mas GATEWAY_ACTIVE não estiver, envie mensagens para o cliente somente do servidor RAS ao qual o cliente está conectado.

wszUserName

Uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do usuário remoto conectado a essa porta.

wszComputer

Uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do computador cliente remoto.

dwStartSessionTime

Especifica a hora, em segundos a partir de 1º de janeiro de 1970, que o cliente se conectou ao servidor RAS nessa porta. Use as funções de hora padrão para formatar esse valor para exibição.

wszLogonDomain

Especifica uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do domínio no qual o usuário remoto foi autenticado. Essa cadeia de caracteres é apenas o nome de domínio, sem nenhum prefixo "\\".

fAdvancedServer

Especifica um sinalizador diferente de zero se o servidor RAS associado a essa porta for um servidor avançado, como o Windows 2000 Advanced Server. Use essas informações para determinar o nome do servidor que tem o banco de dados da conta de usuário. Se o servidor RAS for um servidor avançado, obtenha o nome do servidor de conta de usuário concatenando o prefixo "\\" para o nome retornado no membro wszLogonDomain . Isso ocorre porque, para um servidor avançado, o nome de domínio de logon local é o mesmo que o nome do servidor. Se o servidor RAS for uma estação de trabalho, use a função RasAdminGetUserAccountServer para obter o nome do servidor de conta de usuário.

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_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum