_RAS-PORT _ 0-Struktur

[Diese Version der _ RAS-Port _ 0-Struktur wird ab Vista Windows unterstützt. Verwenden Sie stattdessen den neueren _ RAS-PORT _ 0, der 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;

Members

wszPortName

Eine auf NULL beendete Unicode-Zeichenfolge, die den Namen des Ports angibt, z. B. "COM1".

wszDeviceType

Eine auf NULL terminierte Unicode-Zeichenfolge, 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 auf dem Server installierten Gerätetypen, einschließlich Drittanbietergeräten.

wszDeviceName

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

wszMediaName

Gibt eine auf NULL terminierte Unicode-Zeichenfolge an, die den Namen des mediums angibt, das für die Verbindung verwendet wird, z. B. "lauter" oder "attributapi".

reserved

Reserviert.

Flags

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

Wert Bedeutung
GATEWAY _ AKTIV
Wenn dieses Flag festgelegt ist, ist das NetBIOS-Gateway auf dem Server aktiv.
MESSENGER _ PRESENT
Wenn dieses Flag festgelegt ist, wird der Messenger-Dienst auf dem Remoteclient ausgeführt.
PORT _ MULTILINKED
Wenn dieses Flag festgelegt ist, ist der Port mehrfach mit anderen Ports verknüpft. Verwenden Sie diese Informationen, um den Verbindungsstatus als Multilinkport anzuzeigen.
Bei einem Multilinkport enthält die _ RAS-PORTSTATISTIK-Struktur _ zwei Statistiksätze: einen für den Port allein und einen für die kombinierten Ports in der Multilinkverbindung.
CLIENTCLIENT FÜR DEN CLIENT _
Wenn dieses Flag festgelegt ist, hat der Remoteclient eine Verbindung mithilfe von PPP hergestellt. Wenn dieses Flag nicht festgelegt ist, ist der Remoteclient über das AMB-Protokoll verbunden.
_REMOTEÜBERWACHUNG
Wenn dieses Flag festgelegt ist, wird der RemoteListen-Parameter des NetBIOS-Gateways auf dem Server auf 1 festgelegt.
BENUTZER _ AUTHENTIFIZIERT
Wenn dieses Flag festgelegt ist, wird ein Remoteclient mit dem Server verbunden, und der Benutzer wurde authentifiziert. Überprüfen 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 Verwaltungsnachricht an _ _ den _ Remoteclient zu senden. Wenn MESSENGER PRESENT und REMOTE LISTEN festgelegt sind, GATEWAY ACTIVE jedoch nicht, senden Sie Nachrichten nur von dem RAS-Server, mit dem der Client _ _ verbunden _ ist, an den Client.

wszUserName

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

wszComputer

Eine auf NULL beendete Unicode-Zeichenfolge, die den Namen des Remoteclientcomputers angibt.

dwStartSessionTime

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

wszLogonDomain

Gibt eine auf NULL terminierte Unicode-Zeichenfolge an, die den Namen der Domäne angibt, in der 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 ist, z. B. Windows 2000 Advanced Server. Verwenden Sie diese Informationen, um den Namen des Servers zu bestimmen, der über die Benutzerkontodatenbank verfügt. Wenn der RAS-Server ein erweiterter Server ist, erhalten Sie den Namen des Benutzerkontoservers, indem Sie das Präfix " " mit dem Namen verketten, der im \ \ wszLogonDomain-Mitglied 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 RasAdminGetUserAccountServer-Funktion, um den Namen des Benutzerkontoservers zu erhalten.

Requirements (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

Weitere Informationen

Ras-Dienst (RAS): Übersicht

RAS-Serververwaltungsstrukturen

_RAS-PORT _ 1

_ _ RAS-PORTSTATISTIK

RasAdminGetUserAccountServer

RasAdminPortEnum