RAS_CONNECTION_EX struttura (mprapi.h)

Articolo
08/24/2023

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_2 e 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 .

Nota Il membro di revisione dell'intestazione deve essere MPRAPI_RAS_CONNECTION_OBJECT_REVISION_1 e il tipo deve essere MPRAPI_OBJECT_TYPE_RAS_CONNECTION_OBJECT.

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
RAS_FLAGS_PPP_CONNECTION 0x00000001	La connessione usa il protocollo DA punto a punto (PPP).
RAS_FLAGS_MESSENGER_PRESENT 0x00000002	Il servizio messenger è attivo nel client e i messaggi possono essere inviati al client usando MprAdminSendUserMessage.
RAS_FLAGS_QUARANTINE_PRESENT 0x00000008	La connessione è attualmente in quarantena. Per informazioni su come rimuovere la connessione dalla quarantena, vedere MprAdminConnectionRemoveQuarantine.
RAS_FLAGS_ARAP_CONNECTION 0x00000010	La connessione usa AppleTalk Remote Access Protocol (ARAP).
RAS_FLAGS_IKEV2_CONNECTION 0x00000010	La connessione usa IKEv2.
RAS_FLAGS_DORMANT 0x00000020	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.