RAS_CONNECTION_0-Struktur (mprapi.h)

Artikel
08/24/2023

Die RAS_CONNECTION_0-Struktur enthält allgemeine Informationen zu einer bestimmten Verbindung, z. B. Benutzername oder Domäne. Ausführlichere Informationen zu einer bestimmten Verbindung, z. B. gesendete oder empfangene Bytes, finden Sie unter RAS_CONNECTION_1.

Syntax

typedef struct _RAS_CONNECTION_0 {
  HANDLE                hConnection;
  HANDLE                hInterface;
  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];
} RAS_CONNECTION_0, *PRAS_CONNECTION_0;

Members

hConnection

Ein Handle für die Verbindung.

hInterface

Ein Handle für die Schnittstelle.

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.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	mprapi.h