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.
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 |
|---|---|
|
Die Verbindung verwendet das Point-to-Point-Protokoll (PPP). |
|
Der Messengerdienst ist auf dem Client aktiv, und Nachrichten können mithilfe von MprAdminSendUserMessage an den Client gesendet werden. |
|
Die Verbindung befindet sich derzeit in Quarantäne. Informationen zum Entfernen der Verbindung aus der Quarantäne finden Sie unter MprAdminConnectionRemoveQuarantine. |
|
Die Verbindung verwendet das AppleTalk-Remotezugriffsprotokoll (ARAP). |
|
Die Verbindung verwendet IKEv2. |
|
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 |