Freigeben über


RAS_CONNECTION_EX-Struktur (mprapi.h)

Die RAS_CONNECTION_EX-Struktur enthält spezifische Informationen für die Verbindung, die folgendes umfasst: Den Benutzernamen, die Domäne und die GUID (Globally Unique Identifier), die der Verbindung zugeordnet sind, den Nap-Quarantänestatus (Network Access Protection), die Paketstatistik sowie die Point-to-Point(PPP) und Internet Key Exchange Version 2 (IKEv2) bezogene Informationen.

Die RAS_CONNECTION_EX-Struktur enthält die meisten der gleichen Informationen wie die RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 und RAS_CONNECTION_3 kombinierten Strukturen.

Syntax

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

Eine MPRAPI_OBJECT_HEADER-Struktur , die die Version der RAS_CONNECTION_EX-Struktur angibt.

Hinweis Das Revisionsmember von Header muss MPRAPI_RAS_CONNECTION_OBJECT_REVISION_1 und der TypMPRAPI_OBJECT_TYPE_RAS_CONNECTION_OBJECT sein.
 

dwConnectDuration

Ein Wert, der die Dauer der Verbindung in Sekunden darstellt.

dwInterfaceType

Eine ROUTER_INTERFACE_TYPE-Enumeration , die den Typ der Verbindungsschnittstelle identifiziert.

dwConnectionFlags

Eine Bitmap von Flags, die Verbindungsattribute angeben. dwConnectionFlags muss mindestens einen der folgenden Werte enthalten:

Wert Bedeutung
RAS_FLAGS_PPP_CONNECTION
0x00000001
Die Verbindung verwendet das Point-to-Point-Protokoll (PPP).
RAS_FLAGS_MESSENGER_PRESENT
0x00000002
Der Messengerdienst ist auf dem Client aktiv, und Nachrichten können mithilfe von MprAdminSendUserMessage an den Client gesendet werden.
RAS_FLAGS_QUARANTINE_PRESENT
0x00000008
Die Verbindung befindet sich derzeit in Quarantäne. Informationen zum Entfernen der Verbindung aus der Quarantäne finden Sie unter MprAdminConnectionRemoveQuarantine.
RAS_FLAGS_ARAP_CONNECTION
0x00000010
Die Verbindung verwendet das AppleTalk-Remotezugriffsprotokoll (ARAP).
RAS_FLAGS_IKEV2_CONNECTION
0x00000010
Die Verbindung verwendet IKEv2.
RAS_FLAGS_DORMANT
0x00000020
Die Verbindung verwendet IKEv2, und der Server ist nicht erreichbar.

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen der Schnittstelle für diese Verbindung enthält.

wszUserName[UNLEN + 1]

Eine mit Null beendete Unicode-Zeichenfolge, die den Namen des Benutzers enthält, der sich bei der Verbindung angemeldet hat.

wszLogonDomain[DNLEN + 1]

Eine mit NULL beendete Unicode-Zeichenfolge, die die Domäne enthält, in der der verbundene Benutzer authentifiziert ist.

wszRemoteComputer[NETBIOS_NAME_LEN + 1]

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Remotecomputers enthält.

guid

Eine GUID, die die Verbindung identifiziert. Für eingehende Verbindungen ist diese GUID nur gültig, solange die Verbindung aktiv ist.

rasQuarState

Eine RAS_QUARANTINE_STATE-Struktur , die den NAP-Quarantänestatus der Verbindung angibt.

probationTime

Eine FILETIME-Struktur, die die erforderliche Zeit angibt, bis die Verbindung aus der Quarantäne kommt, nach der die Verbindung abgebrochen wird. Dieser Wert ist nur gültig, wenn rasQuarState den Wert RAS_QUAR_STATE_PROBATION hat.

dwBytesXmited

Ein -Wert, der die Anzahl der von der Verbindung übertragenen Bytes angibt.

dwBytesRcved

Ein Wert, der die Anzahl der Bytes angibt, die für die Verbindung empfangen werden.

dwFramesXmited

Ein Wert, der die Anzahl von Frames angibt, die über die Verbindung übertragen werden.

dwFramesRcved

Ein Wert, der die Anzahl der Frames angibt, die für die Verbindung empfangen werden.

dwCrcErr

Ein Wert, der die Anzahl der Fehler bei der Zyklischen Redundanzprüfung (CRC) für die Verbindung angibt.

dwTimeoutErr

Ein Wert, der die Anzahl von Timeoutfehlern für die Verbindung angibt.

dwAlignmentErr

Ein Wert, der die Anzahl von Ausrichtungsfehlern für die Verbindung angibt.

dwHardwareOverrunErr

Ein Wert, der die Anzahl von Hardwareüberlauffehlern für die Verbindung angibt.

dwFramingErr

Ein Wert, der die Anzahl von Rahmenfehlern für die Verbindung angibt.

dwBufferOverrunErr

Ein Wert, der die Anzahl von Pufferüberlauffehlern für die Verbindung angibt.

dwCompressionRatioIn

Ein Wert, der den Prozentsatz angibt, um den daten, die für diese Verbindung empfangen werden, komprimiert werden. dwCompressionRatioIn ist die Größe der komprimierten Daten geteilt durch die Größe derselben Daten in einem nicht komprimierten Zustand.

dwCompressionRatioOut

Ein Wert, der den Prozentsatz angibt, um den die von dieser Verbindung übertragenen Daten komprimiert werden. Das Verhältnis ist die Größe der komprimierten Daten dividiert durch die Größe der gleichen Daten in einem nicht komprimierten Zustand.

dwNumSwitchOvers

Ein Wert, der die Anzahl der MOBIKE-Switches (IKEv2 Mobility and Multihoming Protocol) angibt, die für die Verbindung aufgetreten sind, wie in RFC4555 definiert. dwNumSwitchOvers ist nur gültig, wenn dwConnectionFlagsRAS_FLAGS_IKEV2_CONNECTION ist.

wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]

Eine Unicode-Zeichenfolge mit Null-Endung, die die IP-Adresse des Remotecomputers in der Verbindung enthält. Diese Zeichenfolge hat das Format "a.b.c.d".

wszLocalEndpointAddress[MAXIPADRESSLEN + 1]

Eine Unicode-Zeichenfolge mit Null-Endung, die die IP-Adresse des lokalen Computers in der Verbindung enthält. Diese Zeichenfolge hat das Format "a.b.c.d".

ProjectionInfo

Eine PROJECTION_INFO-Struktur , die entweder eine PPP_PROJECTION_INFO - oder IKEV2_PROJECTION_INFO-Struktur enthält.

hConnection

Ein Handle für die RAS-Verbindung.

hInterface

Ein Handle für die RAS-Verbindungsschnittstelle.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile mprapi.h

Weitere Informationen

MprAdminConnectionEnum

RAS-Verwaltungsstrukturen

RAS_CONNECTION_0

RAS_CONNECTION_1

RAS_CONNECTION_2

RAS_CONNECTION_3

Referenz zur Remotezugriffsdienstverwaltung