struttura RAS_CONNECTION_4 (mprapi.h)
Contiene informazioni specifiche per la connessione che include: il nome utente, il dominio, il GUID (Global Unique Identifier) associato alla connessione, lo stato di quarantena protezione accesso alla rete (NAP), le statistiche sui pacchetti, nonché le relative informazioni correlate da punto a punto (PPP) e Internet Key Exchange versione 2 (IKEv2).
Sintassi
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;
Members
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. Il membro dwConnectionFlags deve contenere almeno uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
La connessione usa il protocollo PP (Point-to-Point Protocol). |
|
Il servizio messenger è attivo nel client e i messaggi possono essere inviati al client usando la funzione 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 che contiene il dominio in cui viene autenticato l'utente connesso.
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 protezione accesso alla rete della connessione.
probationTime
Struttura FILETIME che specifica il tempo necessario per uscire dalla quarantena della connessione dopo la quale la connessione verrà eliminata. Questo valore è valido solo se il membro rasQuarState ha un valore di RAS_QUAR_STATE_PROBATION.
connectionStartTime
Struttura FILETIME che specifica l'ora di inizio della connessione in formato UTC.
ullBytesXmited
Valore che specifica il numero di byte trasmessi sulla connessione.
ullBytesRcved
Valore che specifica il numero di byte ricevuti nella connessione.
dwFramesXmited
Valore che specifica il numero di fotogrammi trasmessi sulla connessione.
dwFramesRcved
Valore che specifica il numero di fotogrammi ricevuti nella connessione.
dwCrcErr
Valore che specifica il numero di errori CRC (Cyclic Redundancy Check) 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 sovraccarico del buffer nella connessione.
dwCompressionRatioIn
Valore che specifica la percentuale in base alla quale i dati ricevuti in questa connessione vengono compressi. Il membro dwCompressionRatioIn è la dimensione dei dati compressi divisi per le 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 divisi per le 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 nella connessione. Il membro dwNumSwitchOvers è valido solo se il membro 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_INFO2 che contiene una struttura PPP_PROJECTION_INFO2 o una struttura IKEV2_PROJECTION_INFO2 .
hConnection
Handle per la connessione RAS.
hInterface
Handle per l'interfaccia di connessione RAS.
dwDeviceType
Valore che specifica il tipo di tunnel della connessione VPN. Nella tabella seguente vengono illustrati i valori possibili per questo membro.
| Valore | Significato |
|---|---|
|
Tunnel da punto a punto (PPTP) |
|
Tunnel L2TP |
|
Tunnel SSTP |
|
Tunnel IKEv2 |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Intestazione | mprapi.h |