RAS_CONNECTION_4 structure (mprapi.h)
Contient des informations spécifiques pour la connexion, notamment : le nom d’utilisateur, le domaine, l’identificateur global unique (GUID) associé à la connexion, l’état de quarantaine nap (Network Access Protection), les statistiques de paquets, ainsi que ses informations relatives au point (PPP) et à Internet Key Exchange version 2 (IKEv2).
Syntaxe
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;
Membres
dwConnectDuration
Valeur qui représente la durée de la connexion en secondes.
dwInterfaceType
Énumération ROUTER_INTERFACE_TYPE qui identifie le type d’interface de connexion.
dwConnectionFlags
Bitmap d’indicateurs qui spécifient des attributs de connexion. Le membre dwConnectionFlags doit contenir au moins l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
La connexion utilise le protocole PPP (Point-to-Point Protocol). |
|
Le service de messagerie est actif sur le client et les messages peuvent être envoyés au client à l’aide de la fonction MprAdminSendUserMessage . |
|
La connexion est actuellement en quarantaine. Pour plus d’informations sur la suppression de la connexion de la quarantaine, consultez MprAdminConnectionRemoveQuarantine. |
|
La connexion utilise le protocole ARAP (Remote Access Protocol) AppleTalk. |
|
La connexion utilise IKEv2. |
|
La connexion utilise IKEv2 et le serveur n’est pas accessible. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
Chaîne Unicode terminée par un caractère Null qui contient le nom de l’interface pour cette connexion.
wszUserName[UNLEN + 1]
Chaîne Unicode terminée par null qui contient le nom de l’utilisateur connecté à la connexion.
wszLogonDomain[DNLEN + 1]
Chaîne Unicode terminée par null qui contient le domaine sur lequel l’utilisateur connecté est authentifié.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
Chaîne Unicode terminée par null qui contient le nom de l’ordinateur distant.
guid
GUID qui identifie la connexion. Pour les connexions entrantes, ce GUID est valide uniquement tant que la connexion est active.
rasQuarState
Structure RAS_QUARANTINE_STATE qui spécifie l’état de quarantaine NAP de la connexion.
probationTime
Structure FILETIME qui spécifie le temps nécessaire pour que la connexion sorte de la quarantaine après laquelle la connexion sera supprimée. Cette valeur est valide uniquement si le membre rasQuarState a une valeur de RAS_QUAR_STATE_PROBATION.
connectionStartTime
Structure FILETIME qui spécifie l’heure de début de la connexion en UTC.
ullBytesXmited
Valeur qui spécifie le nombre d’octets transmis sur la connexion.
ullBytesRcved
Valeur qui spécifie le nombre d’octets reçus sur la connexion.
dwFramesXmited
Valeur qui spécifie le nombre d’images transmises sur la connexion.
dwFramesRcved
Valeur qui spécifie le nombre de trames reçues sur la connexion.
dwCrcErr
Valeur qui spécifie le nombre d’erreurs de vérification de redondance cyclique (CRC) sur la connexion.
dwTimeoutErr
Valeur qui spécifie le nombre d’erreurs de délai d’attente sur la connexion.
dwAlignmentErr
Valeur qui spécifie le nombre d’erreurs d’alignement sur la connexion.
dwHardwareOverrunErr
Valeur qui spécifie le nombre d’erreurs de dépassement de matériel sur la connexion.
dwFramingErr
Valeur qui spécifie le nombre d’erreurs de cadrage sur la connexion.
dwBufferOverrunErr
Valeur qui spécifie le nombre d’erreurs de dépassement de mémoire tampon sur la connexion.
dwCompressionRatioIn
Valeur qui spécifie le pourcentage de compression des données reçues sur cette connexion. Le membre dwCompressionRatioIn est la taille des données compressées divisée par la taille des mêmes données dans un état non compressé.
dwCompressionRatioOut
Valeur qui spécifie le pourcentage de compression des données transmises sur cette connexion. Le ratio est la taille des données compressées divisée par la taille des mêmes données dans un état non compressé.
dwNumSwitchOvers
Valeur qui spécifie le nombre de commutateurs MOBIKE (Mobility and Multihoming Protocol) IKEv2 qui se sont produits sur la connexion. Le membre dwNumSwitchOvers n’est valide que si le membre dwConnectionFlags est RAS_FLAGS_IKEV2_CONNECTION.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Chaîne Unicode terminée par null qui contient l’adresse IP de l’ordinateur distant dans la connexion. Cette chaîne a la forme « a.b.c.d ».
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Chaîne Unicode terminée par null qui contient l’adresse IP de l’ordinateur local dans la connexion. Cette chaîne a la forme « a.b.c.d ».
ProjectionInfo
Structure PROJECTION_INFO2 qui contient une structure PPP_PROJECTION_INFO2 ou une structure IKEV2_PROJECTION_INFO2 .
hConnection
Handle de la connexion RAS.
hInterface
Handle de l’interface de connexion RAS.
dwDeviceType
Valeur qui spécifie le type de tunnel de la connexion VPN. Le tableau suivant montre les valeurs possibles pour ce membre.
| Valeur | Signification |
|---|---|
|
Tunnel point à point (PPTP) |
|
Tunnel L2TP |
|
Tunnel SSTP |
|
Tunnel IKEv2 |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| En-tête | mprapi.h |