RAS_CONNECTION_4-Struktur (mprapi.h)
Enthält spezifische Informationen für die Verbindung, die folgendes umfasst: Benutzername, Domäne, GUID (Globally Unique Identifier), der der Verbindung zugeordnet ist, NAP-Quarantänestatus (Network Access Protection), Paketstatistiken sowie informationen zu Point-to-Point (PPP) und Internet Key Exchange Version 2 (IKEv2).
Syntax
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;
Member
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 mit Flags, die Verbindungsattribute angeben. Der dwConnectionFlags-Member muss mindestens einen der folgenden Werte enthalten.
| Wert | Bedeutung |
|---|---|
|
Die Verbindung wird über das Point-to-Point-Protokoll (PPP) hergestellt. |
|
Der Messengerdienst ist auf dem Client aktiv, und Nachrichten können mithilfe der Funktion 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 wird über das AppleTalk-Remotezugriffsprotokoll (ARAP) hergestellt. |
|
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-Termin, die den Namen der Schnittstelle für diese Verbindung enthält.
wszUserName[UNLEN + 1]
Eine unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Benutzers enthält, der bei der Verbindung angemeldet ist.
wszLogonDomain[DNLEN + 1]
Eine unicode-Zeichenfolge mit Null-Termin, die die Domäne enthält, für die der verbundene Benutzer authentifiziert ist.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
Eine Unicode-Zeichenfolge mit Null-Termin, 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 Zeit angibt, die erforderlich ist, bis die Verbindung aus der Quarantäne kommt, nach der die Verbindung abgebrochen wird. Dieser Wert ist nur gültig, wenn der rasQuarState-Member den Wert RAS_QUAR_STATE_PROBATION hat.
connectionStartTime
Eine FILETIME-Struktur , die die Startzeit der Verbindung in UTC angibt.
ullBytesXmited
Ein -Wert, der die Anzahl von Bytes angibt, die bei der Verbindung übertragen werden.
ullBytesRcved
Ein -Wert, der die Anzahl der Bytes angibt, die für die Verbindung empfangen werden.
dwFramesXmited
Ein -Wert, der die Anzahl der 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 von CRC-Fehlern (Cyclic Redundancy Check) 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 die bei dieser Verbindung empfangenen Daten komprimiert werden. Der dwCompressionRatioIn-Member ist die Größe der komprimierten Daten dividiert durch die Größe der gleichen Daten in einem nicht komprimierten Zustand.
dwCompressionRatioOut
Ein -Wert, der den Prozentsatz angibt, um den die über diese 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-Schalter (IKEv2 Mobility and Multihoming Protocol) angibt, die für die Verbindung aufgetreten sind. Das dwNumSwitchOvers-Element ist nur gültig, wenn das dwConnectionFlags-ElementRAS_FLAGS_IKEV2_CONNECTION ist.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Eine mit NULL endende Unicode-Zeichenfolge, die die IP-Adresse des Remotecomputers in der Verbindung enthält. Diese Zeichenfolge hat die Form "a.b.c.d".
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Eine Unicode-Zeichenfolge mit Null-Termin, die die IP-Adresse des lokalen Computers in der Verbindung enthält. Diese Zeichenfolge hat die Form "a.b.c.d".
ProjectionInfo
Eine PROJECTION_INFO2-Struktur , die entweder eine PPP_PROJECTION_INFO2-Struktur oder eine IKEV2_PROJECTION_INFO2-Struktur enthält.
hConnection
Ein Handle für die RAS-Verbindung.
hInterface
Ein Handle für die RAS-Verbindungsschnittstelle.
dwDeviceType
Ein -Wert, der den Tunneltyp der VPN-Verbindung angibt. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.
| Wert | Bedeutung |
|---|---|
|
Point-to-Point-Tunnel (PPTP) |
|
L2TP-Tunnel |
|
SSTP-Tunnel |
|
IKEv2-Tunnel |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | mprapi.h |