RAS_CONNECTION_EX structure (mprapi.h)

Article
08/24/2023

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 .

Note Le membre de révision de Header doit être MPRAPI_RAS_CONNECTION_OBJECT_REVISION_1 et le type doit être MPRAPI_OBJECT_TYPE_RAS_CONNECTION_OBJECT.

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
RAS_FLAGS_PPP_CONNECTION 0x00000001	La connexion utilise le protocole PPP (Point-to-Point Protocol).
RAS_FLAGS_MESSENGER_PRESENT 0x00000002	Le service de messagerie est actif sur le client et les messages peuvent être envoyés au client à l’aide de MprAdminSendUserMessage.
RAS_FLAGS_QUARANTINE_PRESENT 0x00000008	La connexion est actuellement en quarantaine. Pour plus d’informations sur la suppression de la connexion de la quarantaine, consultez MprAdminConnectionRemoveQuarantine.
RAS_FLAGS_ARAP_CONNECTION 0x00000010	La connexion utilise le protocole ARAP (Remote Access Protocol) AppleTalk.
RAS_FLAGS_IKEV2_CONNECTION 0x00000010	La connexion utilise IKEv2.
RAS_FLAGS_DORMANT 0x00000020	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