RasAdminPortGetInfo-Funktion

[Diese Funktion wird nur aus Gründen der Abwärtskompatibilität mit Windows NT Server 4.0 bereitgestellt. Auf _ Windows _ Server 2003 wird ERROR CALL NOT _ IMPLEMENTED zurückgegeben. Anwendungen sollten die MprAdminPortGetInfo-Funktion verwenden.]

Die RasAdminPortGetInfo-Funktion ruft Informationen zu einem angegebenen Port auf einem angegebenen Server ab.

Syntax

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

Parameter

lpszServer [ In]

Zeiger auf eine auf NULL endende Unicode-Zeichenfolge, die den Namen des RAS-Servers angibt. Geben Sie den Namen mit führenden Zeichen vom Typ \ \ " " im Format \ \ Servername an.

lpszPort [ In]

Zeiger auf eine auf NULL endende Unicode-Zeichenfolge, die den Namen des Ports auf dem Server angibt.

pRasPort1 [ out]

Zeiger auf die RAS _ PORT _ 1-Struktur, die die Funktion mit Informationen zum Zustand des Ports ausfüllt.

pRasStats [ out]

Zeiger auf die RAS _ PORT _ STATISTICS-Struktur, die die Funktion mit Statistiken zum Port auffüllt.

ppRasParams [ out]

Zeiger auf eine Zeigervariable, die die Adresse eines Arrays von RAS _ PARAMETERS-Strukturen empfängt. Jede Struktur enthält den Namen eines medienspezifischen Schlüssels, z. B. MAXCONNECTBPS, und den zugehörigen Wert. Wenn die Anwendung mit diesem Arbeitsspeicher fertig ist, können Sie sie freigeben, indem Sie die RasAdminFreeBuffer-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert ERROR _ SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Wert Bedeutung
FEHLER _ BEI _ NICHT _ VORHANDENER ENTWICKLUNG
Der angegebene Port ist ungültig.
FEHLER _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Nicht genügend Arbeitsspeicher zum Zuordnen eines Puffers für das ppRasParams-Array.

Für diese Funktion sind keine erweiterten Fehlerinformationen vorhanden. Rufen Sie getLastErrornicht auf.

Anforderungen

Anforderung Wert
Ende des Supports (Client)
Windows 2000 Professional
Ende des Supports (Server)
Windows 2000 Server
Header
Rassapi.h
Bibliothek
Rassapi.lib
DLL
Rassapi.dll

Siehe auch

Remotezugriffsdienst (RAS) – Übersicht

RAS-Serververwaltungsfunktionen

_RAS-PARAMETER

_RAS-PORT _ 1

_ _ RAS-PORTSTATISTIKEN

RasAdminFreeBuffer