estrutura RAS_CONNECTION_EX (mprapi.h)
A estrutura RAS_CONNECTION_EX contém informações específicas para a conexão que inclui: o nome de usuário, o domínio e o GUID (Identificador Global exclusivo) associados à conexão, seu estado de quarentena na PROTEÇÃO de Acesso à Rede (NAP), suas estatísticas de pacote, bem como suas informações relacionadas ponto a ponto (PPP) e IKEv2 (Internet Key Exchange versão 2).
A estrutura RAS_CONNECTION_EX contém a maioria das mesmas informações que as estruturas combinadas RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 e RAS_CONNECTION_3 .
Sintaxe
typedef struct _RAS_CONNECTION_EX {
MPRAPI_OBJECT_HEADER Header;
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;
DWORD dwBytesXmited;
DWORD dwBytesRcved;
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_INFO ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
} RAS_CONNECTION_EX, *PRAS_CONNECTION_EX;
Membros
Header
Uma estrutura MPRAPI_OBJECT_HEADER que especifica a versão da estrutura RAS_CONNECTION_EX .
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. dwConnectionFlags deve conter pelo menos um dos seguintes valores:
| 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 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 rasQuarState tiver um valor de RAS_QUAR_STATE_PROBATION.
dwBytesXmited
Um valor que especifica o número de bytes transmitidos na conexão.
dwBytesRcved
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. 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, conforme definido em RFC4555. dwNumSwitchOvers só será válido se 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_INFO que contém uma estrutura PPP_PROJECTION_INFO ou IKEV2_PROJECTION_INFO .
hConnection
Um identificador para a conexão RAS.
hInterface
Um identificador para a interface de conexão RAS.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | mprapi.h |