Freigeben über


RAS_PORT_1 Struktur

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

Die RAS_PORT_1-Struktur enthält Informationen zu einem RAS-Port.

Syntax

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

Member

rasport0

Gibt eine RAS_PORT_0-Struktur an, die Informationen zum Port enthält, z. B. den Namen des Ports, den Namen des mit dem Port verbundenen Remotebenutzers usw.

LineCondition

Gibt den Status des Ports an. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
RAS_PORT_NON_OPERATIONAL
Der Port ist nicht betriebsbereit. Überprüfen Sie das Ereignisprotokoll auf vom Server gemeldete Fehler.
RAS_PORT_DISCONNECTED
Der Port ist derzeit getrennt.
RAS_PORT_CALLING_BACK
Der RAS-Server ruft den RAS-Client zurück.
RAS_PORT_LISTENING
Der Port wartet auf den Aufruf eines Clients.
RAS_PORT_AUTHENTICATING
Der Server ist gerade dabei, den Remoteclient zu authentifizieren.
RAS_PORT_AUTHENTICATED
Der Remoteclient wird jetzt authentifiziert.
RAS_PORT_INITIALIZING
Das an den Port angefügte Gerät wird initialisiert. Der Status des Ports ändert sich in RAS_PORT_LISTENING, wenn die Initialisierung abgeschlossen ist.

HardwareCondition

Gibt einen der folgenden Werte an, um den Status des an den Port angefügten Geräts anzugeben.

Wert Bedeutung
RAS_MODEM_OPERATIONAL
Das an diesen Port angeschlossene Modem ist betriebsbereit und kann Clientanrufe empfangen.
RAS_MODEM_HARDWARE_FAILURE
Das an diesen Port angeschlossene Modem weist ein Hardwareproblem auf.

LineSpeed

Gibt die Geschwindigkeit in Bits pro Sekunde an, mit der der Computer mit dem Port kommunizieren kann.

NumStatistics

Dieser Member wird nicht verwendet. Die RAS-Verwaltungsfunktionen, z. B. die RasAdminPortGetInfo-Funktion , verwenden die RAS_PORT_STATISTICS-Struktur , um Portstatistiken zurückzugeben.

NumMediaParms

Gibt die Anzahl der medienspezifischen Parameter für diesen Port an. Bei seriellen Medien ist dies in der Regel die Anzahl der Werte, die in der SERIAL.INI-Datei angezeigt werden.

SizeMediaParms

Gibt die Größe des Puffers in Bytes an, der für alle medienspezifischen Parameter erforderlich ist. Die RasAdminPortGetInfo-Funktion gibt einen Puffer zurück, der ein Array von RAS_PARAMETERS Strukturen mit den Medienparametern und -werten für den Port enthält.

ProjResult

Eine RAS_PPP_PROJECTION_RESULT-Struktur , die die PPP-Projektionsinformationen für diesen Port angibt. Diese Struktur stellt Informationen für jedes Protokoll bereit, das ausgehandelt wird, wenn ein RAS-Client eine Verbindung mit einem Server herstellt.

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_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo