estructura RAS_CONNECTION_4 (mprapi.h)
Contiene información específica para la conexión que incluye: el nombre de usuario, el dominio, el identificador único global (GUID) asociado a la conexión, el estado de cuarentena de protección de acceso a la red (NAP), las estadísticas de paquetes, así como su información relacionada con punto a punto (PPP) e Intercambio de claves de Internet versión 2 (IKEv2).
Sintaxis
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;
Miembros
dwConnectDuration
Valor que representa la duración de la conexión en segundos.
dwInterfaceType
Enumeración ROUTER_INTERFACE_TYPE que identifica el tipo de interfaz de conexión.
dwConnectionFlags
Mapa de bits de marcas que especifican atributos de conexión. El miembro dwConnectionFlags debe contener al menos uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
La conexión usa el protocolo de punto a punto (PPP). |
|
El servicio messenger está activo en el cliente y los mensajes se pueden enviar al cliente mediante la función MprAdminSendUserMessage . |
|
La conexión está actualmente en cuarentena. Para obtener información sobre cómo quitar la conexión de la cuarentena, consulte MprAdminConnectionRemoveQuarantine. |
|
La conexión usa el Protocolo de acceso remoto (ARAP) de AppleTalk. |
|
La conexión usa IKEv2. |
|
La conexión usa IKEv2 y el servidor no es accesible. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Cadena Unicode terminada en null que contiene el nombre de la interfaz para esta conexión.
wszUserName[UNLEN + 1]
Cadena Unicode terminada en null que contiene el nombre del usuario que inició sesión en la conexión.
wszLogonDomain[DNLEN + 1]
Cadena Unicode terminada en null que contiene el dominio en el que se autentica el usuario conectado.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
Cadena Unicode terminada en null que contiene el nombre del equipo remoto.
guid
GUID que identifica la conexión. Para las conexiones entrantes, este GUID solo es válido siempre que la conexión esté activa.
rasQuarState
Estructura RAS_QUARANTINE_STATE que especifica el estado de cuarentena nap de la conexión.
probationTime
Estructura FILETIME que especifica el tiempo necesario para que la conexión salga de la cuarentena después de la cual se quitará la conexión. Este valor solo es válido si el miembro rasQuarState tiene un valor de RAS_QUAR_STATE_PROBATION.
connectionStartTime
Estructura FILETIME que especifica la hora de inicio de la conexión en UTC.
ullBytesXmited
Valor que especifica el número de bytes transmitidos en la conexión.
ullBytesRcved
Valor que especifica el número de bytes recibidos en la conexión.
dwFramesXmited
Valor que especifica el número de fotogramas transmitidos en la conexión.
dwFramesRcved
Valor que especifica el número de fotogramas recibidos en la conexión.
dwCrcErr
Valor que especifica el número de errores de comprobación de redundancia cíclica (CRC) en la conexión.
dwTimeoutErr
Valor que especifica el número de errores de tiempo de espera en la conexión.
dwAlignmentErr
Valor que especifica el número de errores de alineación en la conexión.
dwHardwareOverrunErr
Valor que especifica el número de errores de saturación de hardware en la conexión.
dwFramingErr
Valor que especifica el número de errores de trama en la conexión.
dwBufferOverrunErr
Valor que especifica el número de errores de saturación del búfer en la conexión.
dwCompressionRatioIn
Valor que especifica el porcentaje por el que se comprimen los datos recibidos en esta conexión. El miembro dwCompressionRatioIn es el tamaño de los datos comprimidos divididos por el tamaño de los mismos datos en un estado sin comprimir.
dwCompressionRatioOut
Valor que especifica el porcentaje por el que se comprimen los datos transmitidos en esta conexión. La relación es el tamaño de los datos comprimidos divididos por el tamaño de los mismos datos en un estado sin comprimir.
dwNumSwitchOvers
Valor que especifica el número de conmutadores IKEv2 Mobility and Multihoming Protocol (MOBIKE) que se han producido en la conexión. El miembro dwNumSwitchOvers solo es válido si el miembro dwConnectionFlags es RAS_FLAGS_IKEV2_CONNECTION.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Cadena Unicode terminada en null que contiene la dirección IP del equipo remoto en la conexión. Esta cadena tiene el formato "a.b.c.d".
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Cadena Unicode terminada en null que contiene la dirección IP del equipo local en la conexión. Esta cadena tiene el formato "a.b.c.d".
ProjectionInfo
Estructura PROJECTION_INFO2 que contiene una estructura de PPP_PROJECTION_INFO2 o una estructura de IKEV2_PROJECTION_INFO2 .
hConnection
Identificador de la conexión RAS.
hInterface
Identificador de la interfaz de conexión RAS.
dwDeviceType
Valor que especifica el tipo de túnel de la conexión VPN. En la tabla siguiente se muestran los valores posibles para este miembro.
| Valor | Significado |
|---|---|
|
Túnel punto a punto (PPTP) |
|
Túnel L2TP |
|
Túnel SSTP |
|
Túnel IKEv2 |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Encabezado | mprapi.h |