RAS_CONNECTION_EX structure (mprapi.h)
La structure RAS_CONNECTION_EX contient des informations spécifiques pour la connexion, notamment : le nom d’utilisateur, le domaine et l’identificateur global unique (GUID) associés à la connexion, son état de quarantaine NAP (Network Access Protection), ses statistiques de paquets, ainsi que ses informations relatives au point à point (PPP) et à Internet Key Exchange version 2 (IKEv2).
La structure RAS_CONNECTION_EX contient la plupart des mêmes informations que les structures combinées RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 et RAS_CONNECTION_3 .
Syntaxe
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;
Membres
Header
Structure MPRAPI_OBJECT_HEADER qui spécifie la version de la structure RAS_CONNECTION_EX .
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. 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 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 rasQuarState a une valeur de RAS_QUAR_STATE_PROBATION.
dwBytesXmited
Valeur qui spécifie le nombre d’octets transmis sur la connexion.
dwBytesRcved
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. 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, comme défini dans RFC4555. dwNumSwitchOvers n’est valide que si 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_INFO qui contient une structure PPP_PROJECTION_INFO ou IKEV2_PROJECTION_INFO .
hConnection
Handle de la connexion RAS.
hInterface
Handle de l’interface de connexion RAS.
Spécifications
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | mprapi.h |
Voir aussi
Structures d’administration RAS
Informations de référence sur l’administration du service d’accès à distance