Informationen zu RAS-Server und Portverwaltung

Die RAS-Serververwaltungsfunktionen erhalten Informationen zu einem angegebenen RAS-Server und dessen Ports. Diese Funktionen werden auch verwendet, um eine Verbindung an einem angegebenen RAS-Serverport zu beenden.

Die Funktion MprAdminServerGetInfo gibt eine MPR_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 Verbindungen verfügbaren Ports, die Anzahl der derzeit verwendeten Ports und die Serverversionsnummer.

Die MprAdminPortEnum-Funktion ruft ein Array von RAS_PORT_0 Strukturen ab. Jede Struktur enthält Informationen zu einem der Ports, 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 ras-Server, der dem Port zugeordnet ist, ein Windows NT/Windows 2000 Server ist
• Ob der Port derzeit verwendet wird, und, falls vorhanden, Informationen zur Verbindung

Um die ports abzurufen, die von einer bestimmten Verbindung verwendet werden, übergeben Sie MprAdminPortEnum ein Handle an diese Verbindung im hConnection-Parameter . Verwenden Sie die Funktion MprAdminConnectionEnum , um ein Handle für eine Verbindung abzurufen. Wenn Sie eine RAS-Verwaltungs-DLL implementiert haben, erhalten die Funktionen MprAdminAcceptNewConnection und MprAdminAcceptNewConnection2 zum Zeitpunkt der Verbindungsherstellung ein Handle für jede neue Verbindung.

Sie können die MprAdminPortGetInfo-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 Status 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 MprAdminPortGetInfo-Funktion gibt auch eine RAS_PORT_STATISTICS-Struktur zurück, die verschiedene Statistikindikatoren für die aktuelle Verbindung (falls vorhanden) am Port enthält. Für einen Port, der Teil einer Multilinkverbindung ist, gibt MprAdminPortGetInfo 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 Funktion MprAdminPortClearStats verwenden, um die Statistikindikatoren für den Port zurückzusetzen. Die MprAdminPortDisconnect-Funktion trennt einen verwendeten Port.

Verwenden Sie die Funktion MprAdminBufferFree , um Arbeitsspeicher freizugeben, der von den Funktionen MprAdminPortEnum und MprAdminPortGetInfo zugewiesen wurde. Verwenden Sie die Funktion MprAdminGetErrorString , um eine Zeichenfolge abzurufen, die einen RAS-Fehlercode beschreibt, der von einer der RAS-Serververwaltungsfunktionen (RasAdmin) zurückgegeben wird.