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