RAS-Server- und Portverwaltung

Mithilfe der RAS-Serververwaltungsfunktionen können Sie Informationen zu einem angegebenen RAS-Server und dessen Ports abrufen. Mit diesen Funktionen können Sie auch eine Verbindung an einem angegebenen RAS-Serverport beenden.

Die RasAdminServerGetInfo-Funktion gibt eine RAS SERVER _ _ 0-Struktur zurück, die Informationen zur Konfiguration eines RAS-Servers enthält. Die zurückgegebenen Informationen umfassen die Anzahl der derzeit für die Verbindung verfügbaren Ports, die Anzahl der derzeit verwendeten Ports und die Serverversionsnummer.

Die RasAdminPortEnum-Funktion ruft ein Array von RAS PORT _ _ 0-Strukturen ab, das Informationen zu jedem der ports enthält, die auf einem RAS-Server konfiguriert sind. Die Informationen für jeden Port umfassen Folgendes:

  • Der Name des Ports
  • Informationen zum Gerät, das an den Port angeschlossen ist
  • Gibt an, ob der dem Port zugeordnete RAS-Server ein Windows NT/Windows 2000-Server ist.
  • Gibt an, ob der Port derzeit verwendet wird, und , falls ja, Informationen zur Verbindung.

Sie können die RasAdminPortGetInfo-Funktion aufrufen, um zusätzliche Informationen zu einem angegebenen Port auf einem RAS-Server abzurufen. Diese Funktion gibt eine RAS _ PORT _ 1-Struktur zurück, die eine RAS PORT _ _ 0-Struktur und zusätzliche Informationen zum aktuellen Zustand des Ports enthält. Die RasAdminPortGetInfo-Funktion gibt auch ein Array von RAS _ PARAMETERS-Strukturen zurück, die die Werte aller medienspezifischen Schlüssel beschreiben, die dem Port zugeordnet sind. Eine RAS _ PARAMETERS-Struktur verwendet einen Wert aus der RAS _ PARAMS _ FORMAT-Enumeration, um das Format des Werts für jeden medienspezifischen Schlüssel anzugeben.

Die RasAdminPortGetInfo-Funktion gibt auch eine RAS PORT _ _ STATISTICS-Struktur zurück, die verschiedene Statistikindikatoren für die aktuelle Verbindung am Port enthält, sofern vorhanden. Für einen Port, der Teil einer Multilinkverbindung ist, gibt RasAdminPortGetInfo Statistiken für den einzelnen Port und kumulative Statistiken für alle ports zurück, die an der Verbindung beteiligt sind. Sie können die RasAdminPortClearStatistics-Funktion verwenden, um die Statistikindikatoren für den Port zurückzusetzen. Die RasAdminPortDisconnect-Funktion trennt einen verwendeten Port.

Verwenden Sie die RasAdminFreeBuffer-Funktion, um den von den Funktionen RasAdminPortEnum und RasAdminPortGetInfo belegten Arbeitsspeicher freizugeben. Verwenden Sie die RasAdminGetErrorString-Funktion, um eine Zeichenfolge abzurufen, die einen RAS-Fehlercode beschreibt, der von einer der RAS-Serververwaltungsfunktionen (RasAdmin) zurückgegeben wird.