RAS_CONNECTION_EX struttura (mprapi.h)
La struttura RAS_CONNECTION_EX contiene informazioni specifiche per la connessione che include: nome utente, dominio e identificatore univoco globale (GUID) associato alla connessione, al relativo stato di quarantena protezione accesso alla rete, alle relative statistiche dei pacchetti, nonché alle relative informazioni correlate da punto a punto (PPP) e Internet Key Exchange versione 2 (IKEv2).
La struttura RAS_CONNECTION_EX contiene la maggior parte delle stesse informazioni delle RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2e RAS_CONNECTION_3 strutture combinate.
Sintassi
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
Struttura MPRAPI_OBJECT_HEADER che specifica la versione della struttura RAS_CONNECTION_EX .
dwConnectDuration
Valore che rappresenta la durata della connessione, in secondi.
dwInterfaceType
Enumerazione ROUTER_INTERFACE_TYPE che identifica il tipo di interfaccia di connessione.
dwConnectionFlags
Bitmap di flag che specificano gli attributi di connessione. dwConnectionFlags deve contenere almeno uno dei valori seguenti:
| Valore | Significato |
|---|---|
|
La connessione usa il protocollo DA punto a punto (PPP). |
|
Il servizio messenger è attivo nel client e i messaggi possono essere inviati al client usando MprAdminSendUserMessage. |
|
La connessione è attualmente in quarantena. Per informazioni su come rimuovere la connessione dalla quarantena, vedere MprAdminConnectionRemoveQuarantine. |
|
La connessione usa AppleTalk Remote Access Protocol (ARAP). |
|
La connessione usa IKEv2. |
|
La connessione usa IKEv2 e il server non è raggiungibile. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Stringa Unicode con terminazione null contenente il nome dell'interfaccia per questa connessione.
wszUserName[UNLEN + 1]
Stringa Unicode con terminazione null contenente il nome dell'utente connesso alla connessione.
wszLogonDomain[DNLEN + 1]
Stringa Unicode con terminazione null contenente il dominio in cui l'utente connesso è autenticato.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
Stringa Unicode con terminazione null contenente il nome del computer remoto.
guid
GUID che identifica la connessione. Per le connessioni in ingresso, questo GUID è valido solo se la connessione è attiva.
rasQuarState
Struttura RAS_QUARANTINE_STATE che specifica lo stato di quarantena nap della connessione.
probationTime
Struttura FILETIME che specifica il tempo necessario per uscire dalla quarantena dopo la quale verrà eliminata la connessione. Questo valore è valido solo se rasQuarState ha un valore di RAS_QUAR_STATE_PROBATION.
dwBytesXmited
Valore che specifica il numero di byte trasmessi nella connessione.
dwBytesRcved
Valore che specifica il numero di byte ricevuti nella connessione.
dwFramesXmited
Valore che specifica il numero di fotogrammi trasmessi nella connessione.
dwFramesRcved
Valore che specifica il numero di fotogrammi ricevuti nella connessione.
dwCrcErr
Valore che specifica il numero di errori CRC (Cyclic Ridondanza) nella connessione.
dwTimeoutErr
Valore che specifica il numero di errori di timeout nella connessione.
dwAlignmentErr
Valore che specifica il numero di errori di allineamento nella connessione.
dwHardwareOverrunErr
Valore che specifica il numero di errori di overrun hardware nella connessione.
dwFramingErr
Valore che specifica il numero di errori di frame nella connessione.
dwBufferOverrunErr
Valore che specifica il numero di errori di overrun del buffer nella connessione.
dwCompressionRatioIn
Valore che specifica la percentuale in base alla quale i dati ricevuti in questa connessione vengono compressi. dwCompressionRatioIn è la dimensione dei dati compressi suddivisi in base alle dimensioni degli stessi dati in uno stato non compresso.
dwCompressionRatioOut
Valore che specifica la percentuale in base alla quale i dati trasmessi in questa connessione vengono compressi. Il rapporto è la dimensione dei dati compressi suddivisi in base alle dimensioni degli stessi dati in uno stato non compresso.
dwNumSwitchOvers
Valore che specifica il numero di commutatori IKEv2 Mobility e Multihoming Protocol (MOBIKE) che si sono verificati sulla connessione, come definito in RFC45555. dwNumSwitchOvers è valido solo se dwConnectionFlags è RAS_FLAGS_IKEV2_CONNECTION.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Stringa Unicode con terminazione null contenente l'indirizzo IP del computer remoto nella connessione. Questa stringa è del formato "a.b.c.d".
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Stringa Unicode con terminazione null contenente l'indirizzo IP del computer locale nella connessione. Questa stringa è del formato "a.b.c.d".
ProjectionInfo
Struttura PROJECTION_INFO che contiene una struttura PPP_PROJECTION_INFO o IKEV2_PROJECTION_INFO .
hConnection
Handle per la connessione RAS.
hInterface
Handle per l'interfaccia di connessione RAS.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | mprapi.h |
Vedi anche
Strutture di amministrazione RAS
Informazioni di riferimento per l'amministrazione del servizio accesso remoto