estructura RAS_CONNECTION_EX (mprapi.h)
La estructura de RAS_CONNECTION_EX contiene información específica para la conexión que incluye: el nombre de usuario, el dominio y el identificador único global (GUID) asociado a la conexión, su estado de cuarentena de protección de acceso a la red (NAP), sus estadísticas de paquetes, así como su información relacionada con punto a punto (PPP) y intercambio de claves de Internet versión 2 (IKEv2).
La estructura RAS_CONNECTION_EX contiene la mayor parte de la misma información que las estructuras combinadas RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 y RAS_CONNECTION_3 combinadas.
Sintaxis
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;
Members
Header
Estructura MPRAPI_OBJECT_HEADER que especifica la versión de la estructura de RAS_CONNECTION_EX .
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. dwConnectionFlags debe contener al menos uno de los siguientes valores:
| 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 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. En el caso de 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 cuarentena después de la cual se quitará la conexión. Este valor solo es válido si rasQuarState tiene un valor de RAS_QUAR_STATE_PROBATION.
dwBytesXmited
Valor que especifica el número de bytes transmitidos en la conexión.
dwBytesRcved
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. 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 tal como se define en RFC4555. dwNumSwitchOvers solo es válido si 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 de PROJECTION_INFO que contiene una estructura PPP_PROJECTION_INFO o IKEV2_PROJECTION_INFO .
hConnection
Identificador de la conexión RAS.
hInterface
Identificador de la interfaz de conexión RAS.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Encabezado | mprapi.h |