RAS_PORT_0-Struktur

Artikel
06/13/2023

[Diese Version der RAS_PORT_0-Struktur wird ab Windows Vista nicht unterstützt. Verwenden Sie stattdessen die neuere RAS_PORT_0 , die in mprapi.h definiert ist.]

Die RAS_PORT_0-Struktur enthält Informationen, die einen RAS-Port beschreiben.

Syntax

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

Member

wszPortName

Eine Unicode-Zeichenfolge mit Null-Termin, die den Namen des Ports angibt, z. B. "COM1".

wszDeviceType

Eine Unicode-Zeichenfolge mit Null-Termin, die den Typ des Geräts angibt, auf dem die Verbindung hergestellt wurde, z. B. Modem oder ISDN. Die Liste der Gerätetypen, die in diesem Member angegeben werden können, enthält alle gerätetypen, die auf dem Server installiert sind, einschließlich der Geräte von Drittanbietern.

wszDeviceName

Eine Unicode-Zeichenfolge mit Null-Termin, die den Namen des Geräts angibt, auf dem die Verbindung hergestellt wurde, z. B. "Hayes 9600" oder "PCIMACISDN1".

wszMediaName

Gibt eine Unicode-Zeichenfolge mit Null-Beendigung an, die den Namen der für die Verbindung verwendeten Medien angibt, z. B. rasser oder rastapi.

reserved

Reserviert.

Flags

Gibt einen Satz von Bitflags an, die die Art der Verbindung angeben, die an diesem Port hergestellt wird. Dieser Member kann eine Kombination der folgenden Flags sein.

Wert	Bedeutung
GATEWAY_ACTIVE	Wenn dieses Flag festgelegt ist, ist das NetBIOS-Gateway auf dem Server aktiv.
MESSENGER_PRESENT	Wenn dieses Flag festgelegt ist, wird der Messengerdienst auf dem Remoteclient ausgeführt.
PORT_MULTILINKED	Wenn dieses Flag festgelegt ist, wird der Port mit anderen Ports verknüpft. Verwenden Sie diese Informationen, um die Verbindung status als mehrfach verknüpften Port anzuzeigen. Für einen mehrverknüpften Port enthält die RAS_PORT_STATISTICS-Struktur zwei Sätze von Statistiken: einen für den Port allein und einen für die kombinierten Ports in der Multilinkverbindung.
PPP_CLIENT	Wenn dieses Flag festgelegt ist, hat der Remoteclient über PPP eine Verbindung hergestellt. Wenn dieses Flag nicht festgelegt ist, wird der Remoteclient mit dem AMB-Protokoll verbunden.
REMOTE_LISTEN	Wenn dieses Flag festgelegt ist, wird der RemoteListen-Parameter des NetBIOS-Gateways auf dem Server auf 1 festgelegt.
USER_AUTHENTICATED	Wenn dieses Flag festgelegt ist, wird ein Remoteclient mit dem Server verbunden, und der Benutzer wurde authentifiziert. Aktivieren Sie dieses Flag, um sicherzustellen, dass ein Client tatsächlich mit einem Port verbunden ist.

Wenn die Flags MESSENGER_PRESENT, GATEWAY_ACTIVE und REMOTE_LISTEN festgelegt sind, verwenden Sie den Messenger-Dienst, um eine Administratornachricht an den Remoteclient zu senden. Wenn MESSENGER_PRESENT und REMOTE_LISTEN festgelegt sind, aber GATEWAY_ACTIVE nicht, senden Sie Nachrichten nur vom RAS-Server an den Client, mit dem der Client verbunden ist.

wszUserName

Eine mit NULL endende Unicode-Zeichenfolge, die den Namen des Remotebenutzers angibt, der mit diesem Port verbunden ist.

wszComputer

Eine Unicode-Zeichenfolge mit Null-Termin, die den Namen des Remoteclientcomputers angibt.

dwStartSessionTime

Gibt die Zeit in Sekunden ab dem 1. Januar 1970 an, zu der der Client eine Verbindung mit dem RAS-Server an diesem Port hergestellt hat. Verwenden Sie die Standardzeitfunktionen, um diesen Wert für die Anzeige zu formatieren.

wszLogonDomain

Gibt eine Mit NULL endende Unicode-Zeichenfolge an, die den Namen der Domäne angibt, für die der Remotebenutzer authentifiziert wurde. Diese Zeichenfolge ist nur der Domänenname ohne Präfix "\\".

fAdvancedServer

Gibt ein Flag ungleich null an, wenn der diesem Port zugeordnete RAS-Server ein erweiterter Server wie Windows 2000 Advanced Server ist. Verwenden Sie diese Informationen, um den Namen des Servers zu ermitteln, der über die Benutzerkontodatenbank verfügt. Wenn der RAS-Server ein erweiterter Server ist, rufen Sie den Namen des Benutzerkontoservers ab, indem Sie das Präfix "\\" mit dem Namen verketten, der im wszLogonDomain-Element zurückgegeben wird. Dies liegt daran, dass für einen erweiterten Server der Name der lokalen Anmeldedomäne mit dem Servernamen identisch ist. Wenn der RAS-Server eine Arbeitsstation ist, verwenden Sie die Funktion RasAdminGetUserAccountServer , um den Namen des Benutzerkontoservers abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003
Header	Rassapi.h

Siehe auch

Übersicht über ras (Remote Access Service, RAS)
RAS-Server-Verwaltungsstrukturen
RAS_PORT_1
RAS_PORT_STATISTICS
RasAdminGetUserAccountServer
RasAdminPortEnum

Freigeben über