estrutura RAS_CONNECTION_4 (mprapi.h)
Contém informações específicas para a conexão que inclui: o nome de usuário, o domínio, o GUID (Identificador Global exclusivo) associado à conexão, o estado de quarentena de NAP (Proteção de Acesso à Rede), as estatísticas de pacotes, bem como suas informações relacionadas ponto a ponto (PPP) e IKEv2 (Internet Key Exchange versão 2).
Sintaxe
typedef struct _RAS_CONNECTION_4 {
DWORD dwConnectDuration;
ROUTER_INTERFACE_TYPE dwInterfaceType;
DWORD dwConnectionFlags;
WCHAR wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
WCHAR wszUserName[UNLEN + 1];
WCHAR wszLogonDomain[DNLEN + 1];
WCHAR wszRemoteComputer[NETBIOS_NAME_LEN + 1];
GUID guid;
RAS_QUARANTINE_STATE rasQuarState;
FILETIME probationTime;
FILETIME connectionStartTime;
ULONGLONG ullBytesXmited;
ULONGLONG ullBytesRcved;
DWORD dwFramesXmited;
DWORD dwFramesRcved;
DWORD dwCrcErr;
DWORD dwTimeoutErr;
DWORD dwAlignmentErr;
DWORD dwHardwareOverrunErr;
DWORD dwFramingErr;
DWORD dwBufferOverrunErr;
DWORD dwCompressionRatioIn;
DWORD dwCompressionRatioOut;
DWORD dwNumSwitchOvers;
WCHAR wszRemoteEndpointAddress[MAXIPADRESSLEN + 1];
WCHAR wszLocalEndpointAddress[MAXIPADRESSLEN + 1];
PROJECTION_INFO2 ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
DWORD dwDeviceType;
} RAS_CONNECTION_4, *PRAS_CONNECTION_4;
Membros
dwConnectDuration
Um valor que representa a duração da conexão em segundos.
dwInterfaceType
Uma enumeração ROUTER_INTERFACE_TYPE que identifica o tipo de interface de conexão.
dwConnectionFlags
Um bitmap de sinalizadores que especificam atributos de conexão. O membro dwConnectionFlags deve conter pelo menos um dos valores a seguir.
| Valor | Significado |
|---|---|
|
A conexão está usando ppp (protocolo ponto a ponto). |
|
O serviço messenger está ativo no cliente e as mensagens podem ser enviadas ao cliente usando a função MprAdminSendUserMessage . |
|
No momento, a conexão está em quarentena. Para obter informações sobre como remover a conexão da quarentena, consulte MprAdminConnectionRemoveQuarantine. |
|
A conexão está usando o ARAP (AppleTalk Remote Access Protocol). |
|
A conexão está usando IKEv2. |
|
A conexão está usando IKEv2 e o servidor não é acessível. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o nome da interface para essa conexão.
wszUserName[UNLEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do usuário conectado à conexão.
wszLogonDomain[DNLEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o domínio no qual o usuário conectado é autenticado.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do computador remoto.
guid
Um GUID que identifica a conexão. Para conexões de entrada, esse GUID é válido apenas enquanto a conexão estiver ativa.
rasQuarState
Uma estrutura RAS_QUARANTINE_STATE que especifica o estado de quarentena NAP da conexão.
probationTime
Uma estrutura FILETIME que especifica o tempo necessário para que a conexão saia da quarentena após a qual a conexão será descartada. Esse valor só será válido se o membro rasQuarState tiver um valor de RAS_QUAR_STATE_PROBATION.
connectionStartTime
Uma estrutura FILETIME que especifica a hora de início da conexão em UTC.
ullBytesXmited
Um valor que especifica o número de bytes transmitidos na conexão.
ullBytesRcved
Um valor que especifica o número de bytes recebidos na conexão.
dwFramesXmited
Um valor que especifica o número de quadros transmitidos na conexão.
dwFramesRcved
Um valor que especifica o número de quadros recebidos na conexão.
dwCrcErr
Um valor que especifica o número de erros de CRC (Verificação de Redundância Cíclica) na conexão.
dwTimeoutErr
Um valor que especifica o número de erros de tempo limite na conexão.
dwAlignmentErr
Um valor que especifica o número de erros de alinhamento na conexão.
dwHardwareOverrunErr
Um valor que especifica o número de erros de estouro de hardware na conexão.
dwFramingErr
Um valor que especifica o número de erros de enquadramento na conexão.
dwBufferOverrunErr
Um valor que especifica o número de erros de estouro de buffer na conexão.
dwCompressionRatioIn
Um valor que especifica o percentual pelo qual os dados recebidos nessa conexão são compactados. O membro dwCompressionRatioIn é o tamanho dos dados compactados divididos pelo tamanho dos mesmos dados em um estado não compactado.
dwCompressionRatioOut
Um valor que especifica o percentual pelo qual os dados transmitidos nessa conexão são compactados. A taxa é o tamanho dos dados compactados divididos pelo tamanho dos mesmos dados em um estado não compactado.
dwNumSwitchOvers
Um valor que especifica o número de comutadores MOBIKE (IKEv2 Mobility and Multihoming Protocol) que ocorreram na conexão. O membro dwNumSwitchOvers só será válido se o membro dwConnectionFlags for RAS_FLAGS_IKEV2_CONNECTION.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o endereço IP do computador remoto na conexão. Essa cadeia de caracteres é do formato "a.b.c.d".
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Uma cadeia de caracteres Unicode terminada em nulo que contém o endereço IP do computador local na conexão. Essa cadeia de caracteres é do formato "a.b.c.d".
ProjectionInfo
Uma estrutura PROJECTION_INFO2 que contém uma estrutura PPP_PROJECTION_INFO2 ou uma estrutura IKEV2_PROJECTION_INFO2 .
hConnection
Um identificador para a conexão RAS.
hInterface
Um identificador para a interface de conexão RAS.
dwDeviceType
Um valor que especifica o tipo de túnel da conexão VPN. A tabela a seguir mostra os valores possíveis para esse membro.
| Valor | Significado |
|---|---|
|
Túnel ponto a ponto (PPTP) |
|
Túnel L2TP |
|
Túnel SSTP |
|
Túnel IKEv2 |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho | mprapi.h |